search

dotnet / AspNetCore.Docs

Documentation for ASP.NET Core
https://docs.microsoft.com/aspnet/core
Creative Commons Attribution 4.0 International
12.6k stars 25.3k forks source link

Adopt param attribute value prefix `@` convention #24769

Closed guardrex closed 2 years ago

guardrex commented 2 years ago

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

rswetnam commented 1 year ago

I found this page confusing. Not sure if I shoiuld start with empty or Blazor Server App or BlazorServer App Empty. After starting on empty and adding MainLayout to root directory, it became obvious that I should have used first option as Nav was missing. MainLayout should have been pasted over Main Layout in Shared Shared Folder. Inconsistent casing , difficult to follow - needs to be looked at more closely

guardrex commented 1 year ago

The "empty" template is a special template without boilerplate code and described in these locations ...

I'll open an issue on the rest. Idk what you mean about inconsistent casing, but I agree that this article could use a simpler set of introductory examples for base use cases. The themed styling example is fine, but it's overkill for the most basic use case. Starting with something simpler and clearer will make the feature easier to understand.

It will take a while to reach the new issue tho. We're buried in .NET 8 work right into 24Q1.

guardrex commented 1 year ago

I opened it here ...

https://github.com/dotnet/AspNetCore.Docs/issues/30107

You can tack on something about "inconsistent casing" if you wish. Idk what you mean by that.

guardrex commented 1 year ago

... and BTW just for future reference, we need a new issue for everything. Open an issue using the This page feedback button and form at the bottom of the English-US topic. Use of the This page feedback form adds metadata to your GitHub issue that cross-links the topic and automatically pings the author.

Capture