Merge pull request #35155 from dotnet/main

Merge to Live

Author: Rick-Anderson

.github/ISSUE_TEMPLATE/doc-request.md

@@ -5,12 +5,12 @@ about: Request a new topic to help us improve
 
 **Help us make content visible**
 
-- Tell us what search terms you used and how you searched docs.
-- Tell us what docs you found that didn't address your concern.
+* Tell us what search terms you used and how you searched docs.
+* Tell us what docs you found that didn't address your concern.
 
 **Describe the new topic**
 
-- Explain why this topic is needed.
-- Suggest a location in the Table of Contents.
-- Write an abstract. In one **short** paragraph, describe what this topic will cover.
-- Create an outline for the new topic. We'll help review the outline and approve it before anyone writes a topic.
+* Explain why this topic is needed.
+* Suggest a location in the Table of Contents.
+* Write an abstract. In one **short** paragraph, describe what this topic will cover.
+* Create an outline for the new topic. We'll help review the outline and approve it before anyone writes a topic.

aspnetcore/blazor/components/index.md

@@ -1071,14 +1071,14 @@ For more information, see <xref:mvc/views/razor>.
 > [!WARNING]
 > Providing initial values for component parameters is supported, but don't create a component that writes to its own parameters after the component is rendered for the first time. For more information, see <xref:blazor/components/overwriting-parameters>.
 
-Component parameters should be declared as *auto-properties*, meaning that they shouldn't contain custom logic in their `get` or `set` accessors. For example, the following `StartData` property is an auto-property:
+Component parameters should be declared as [automatically-implemented properties (*auto properties*)](/dotnet/csharp/programming-guide/classes-and-structs/auto-implemented-properties), meaning that they shouldn't contain custom logic in their `get` or `set` accessors. For example, the following `StartData` property is an auto property:
 
 ```csharp
 [Parameter]
 public DateTime StartData { get; set; }
 ```
 
-Don't place custom logic in the `get` or `set` accessor because component parameters are purely intended for use as a channel for a parent component to flow information to a child component. If a `set` accessor of a child component property contains logic that causes rerendering of the parent component, an infinite rendering loop results.
+Don't place custom logic in the `get` or `set` accessor because component parameters are purely intended for use as a channel for a parent component to flow information to a child component. If a `set` accessor of a child component property contains logic that causes rerendering of the parent component, an infinite rendering loop results. Other side effects include unexpected extra renderings and parameter value overwrites.
 
 To transform a received parameter value:
 

aspnetcore/blazor/fundamentals/routing.md

@@ -1056,6 +1056,7 @@ Navigation.GetUriWithQueryParameters("{URI}", {PARAMETERS})
 Supported types are identical to supported types for route constraints:
 
 * `bool`
+* `DateOnly`
 * `DateTime`
 * `decimal`
 * `double`
@@ -1064,6 +1065,7 @@ Supported types are identical to supported types for route constraints:
 * `int`
 * `long`
 * `string`
+* `TimeOnly`
 
 Supported types include:
 

aspnetcore/data/ef-rp/intro/samples/cu/wwwroot/lib/bootstrap/ISSUE_TEMPLATE.md

@@ -1,22 +1,22 @@
 Before opening an issue:
 
-- [Search for duplicate or closed issues](https://github.com/twbs/bootstrap/issues?utf8=%E2%9C%93&q=is%3Aissue)
-- [Validate](http://validator.w3.org/nu/) and [lint](https://github.com/twbs/bootlint#in-the-browser) any HTML to avoid common problems
-- Prepare a [reduced test case](https://css-tricks.com/reduced-test-cases/) for any bugs
-- Read the [contributing guidelines](https://github.com/twbs/bootstrap/blob/master/CONTRIBUTING.md)
+* [Search for duplicate or closed issues](https://github.com/twbs/bootstrap/issues?utf8=%E2%9C%93&q=is%3Aissue)
+* [Validate](http://validator.w3.org/nu/) and [lint](https://github.com/twbs/bootlint#in-the-browser) any HTML to avoid common problems
+* Prepare a [reduced test case](https://css-tricks.com/reduced-test-cases/) for any bugs
+* Read the [contributing guidelines](https://github.com/twbs/bootstrap/blob/master/CONTRIBUTING.md)
 
 When asking general "how to" questions:
 
-- Please do not open an issue here
-- Instead, ask for help on [StackOverflow, IRC, or Slack](https://github.com/twbs/bootstrap/blob/master/README.md#community)
+* Please do not open an issue here
+* Instead, ask for help on [StackOverflow, IRC, or Slack](https://github.com/twbs/bootstrap/blob/master/README.md#community)
 
 When reporting a bug, include:
 
-- Operating system and version (Windows, Mac OS X, Android, iOS, Win10 Mobile)
-- Browser and version (Chrome, Firefox, Safari, IE, MS Edge, Opera 15+, Android Browser)
-- Reduced test cases and potential fixes using [JS Bin](https://jsbin.com)
+* Operating system and version (Windows, Mac OS X, Android, iOS, Win10 Mobile)
+* Browser and version (Chrome, Firefox, Safari, IE, MS Edge, Opera 15+, Android Browser)
+* Reduced test cases and potential fixes using [JS Bin](https://jsbin.com)
 
 When suggesting a feature, include:
 
-- As much detail as possible for what we should add and why it's important to Bootstrap
-- Relevant links to prior art, screenshots, or live demos whenever possible
+* As much detail as possible for what we should add and why it's important to Bootstrap
+* Relevant links to prior art, screenshots, or live demos whenever possible

aspnetcore/data/scaffold_RP.md

@@ -33,9 +33,9 @@ To launch the interactive tool, run `dotnet scaffold`. The UI changes as more fe
 
 To navigate the UI, use the:
 
-- Up and down arrow keys to navigate the menu items.
-- Enter key to select the highlighted menu item.
-- Select and enter **Back** to return to the previous menu.
+* Up and down arrow keys to navigate the menu items.
+* Enter key to select the highlighted menu item.
+* Select and enter **Back** to return to the previous menu.
 
 ## Create and scaffold a data model in a Razor Pages project
 
@@ -59,11 +59,11 @@ If you have any problems with the following steps, see [Tutorial: Create a Razor
 
   The `dotnet scaffold` tool makes the following changes to the project files:
 
-- A package reference is added for Entity Framework.
-- `Program.cs` is updated to initialize the database connection.
-- `appsettings.json` is updated with connection information.
-- `ContactDbContext.cs` is created and added to the project root directory.
-- Razor Pages for CRUD operations are added to the Pages folder.
+* A package reference is added for Entity Framework.
+* `Program.cs` is updated to initialize the database connection.
+* `appsettings.json` is updated with connection information.
+* `ContactDbContext.cs` is created and added to the project root directory.
+* Razor Pages for CRUD operations are added to the Pages folder.
 
 The content has been generated but the database isn't initialized. Run the following commands to initialize the DB.
 
@@ -75,10 +75,11 @@ dotnet ef database update
 ```
 
 In  The preceding commands:
-- `dotnet tool uninstall --global dotnet-ef` uninstalls the `dotnet-ef` tool. Uninstalling ensures the latest tool is successfully installed. If `dotnet-ef` isn't installed, an error messages **A tool with the package Id 'dotnet-ef' could not be found.** You can ignore this message.
-- `dotnet tool install --global dotnet-ef` installs globally the `dotnet-ef` tool.
-- `dotnet ef migrations add initialMigration` adds the initial migration. For more information, see [Create the initial database schema using EF's migration feature](/aspnet/core/tutorials/razor-pages/model&tabs=visual-studio-code)
-- `dotnet ef database update` applies the migrations to the database.
+
+* `dotnet tool uninstall --global dotnet-ef` uninstalls the `dotnet-ef` tool. Uninstalling ensures the latest tool is successfully installed. If `dotnet-ef` isn't installed, an error messages **A tool with the package Id 'dotnet-ef' could not be found.** You can ignore this message.
+* `dotnet tool install --global dotnet-ef` installs globally the `dotnet-ef` tool.
+* `dotnet ef migrations add initialMigration` adds the initial migration. For more information, see [Create the initial database schema using EF's migration feature](/aspnet/core/tutorials/razor-pages/model&tabs=visual-studio-code)
+* `dotnet ef database update` applies the migrations to the database.
 
 Run the app:
 
@@ -91,7 +92,7 @@ Run the app:
 
 ## Additional resources
 
-- [dotnet scaffold repo on GitHub](https://github.com/dotnet/Scaffolding)
-- [How to manage .NET tools](/dotnet/core/tools/global-tools)
-- [Microsoft.dotnet-scaffold](https://www.nuget.org/packages/Microsoft.dotnet-scaffold) NuGet package.
-- [Detailed tutorial on EF scaffolding Razor Pages](/aspnet/core/data/scaffold_rp)
+* [dotnet scaffold repo on GitHub](https://github.com/dotnet/Scaffolding)
+* [How to manage .NET tools](/dotnet/core/tools/global-tools)
+* [Microsoft.dotnet-scaffold](https://www.nuget.org/packages/Microsoft.dotnet-scaffold) NuGet package.
+* [Detailed tutorial on EF scaffolding Razor Pages](/aspnet/core/data/scaffold_rp)

aspnetcore/diagnostics/bl0001.md

@@ -1,7 +1,7 @@
 ---
 title: "BL0001: Component parameter should have public setters"
 description: "Learn about analysis rule BL0001: Component parameter should have public setters"
-author: pranavkm
+author: guardrex
 monikerRange: '>= aspnetcore-3.1'
 ms.author: riande
 ms.date: 10/21/2021

aspnetcore/diagnostics/bl0002.md

@@ -1,7 +1,7 @@
 ---
 title: "BL0002: Component has multiple CaptureUnmatchedValues parameters"
 description: "Learn about analysis rule BL0002: Component has multiple CaptureUnmatchedValues parameters"
-author: pranavkm
+author: guardrex
 monikerRange: '>= aspnetcore-3.1'
 ms.author: riande
 ms.date: 10/21/2021

aspnetcore/diagnostics/bl0003.md

@@ -1,7 +1,7 @@
 ---
 title: "BL0003: Component parameter with CaptureUnmatchedValues has the wrong type"
 description: "Learn about analysis rule BL0003: Component parameter with CaptureUnmatchedValues has the wrong type"
-author: pranavkm
+author: guardrex
 monikerRange: '>= aspnetcore-3.1'
 ms.author: riande
 ms.date: 10/21/2021

aspnetcore/diagnostics/bl0004.md

@@ -1,7 +1,7 @@
 ---
 title: "BL0004: Component parameter should be public"
 description: "Learn about analysis rule BL0004: Component parameter should be public"
-author: pranavkm
+author: guardrex
 monikerRange: '>= aspnetcore-3.1'
 ms.author: riande
 ms.date: 10/21/2021

aspnetcore/diagnostics/bl0005.md

@@ -1,7 +1,7 @@
 ---
 title: "BL0005: Component parameter should not be set outside of its component"
 description: "Learn about analysis rule BL0005: Component parameter should not be set outside of its component"
-author: pranavkm
+author: guardrex
 monikerRange: '>= aspnetcore-3.1'
 ms.author: riande
 ms.date: 10/21/2021