diff --git a/docs/csharp/linq/standard-query-operators/join-operations.md b/docs/csharp/linq/standard-query-operators/join-operations.md index dbe2c02b5f183..9aaf876211d44 100644 --- a/docs/csharp/linq/standard-query-operators/join-operations.md +++ b/docs/csharp/linq/standard-query-operators/join-operations.md @@ -44,7 +44,7 @@ The following example uses the `join … in … on … equals … into …` clau :::code language="csharp" source="./snippets/standard-query-operators/JoinOverviewExamples.cs" id="GroupJoinQuerySyntax"::: You can express the preceding query by using method syntax, as shown in the following example: - + :::code language="csharp" source="./snippets/standard-query-operators/JoinOverviewExamples.cs" id="GroupJoinMethodSyntax"::: ## Perform inner joins @@ -148,7 +148,7 @@ The equivalent query using method syntax is shown in the following code: ## Perform outer joins -.NET 10 includes [`LeftJoin`](https://learn.microsoft.com/dotnet/api/?view=net-10.0&term=LeftJoin) and [`RightJoin`](https://learn.microsoft.com/dotnet/api/?view=net-10.0&term=RightJoin) methods in the and classes. These methods perform an *outer left equijoin*, and an *outer right equijoin*, respectively. An outer left equijoin is a join where every member of the first sequence is included in the output sequence, even if the second sequence doesn't include a match. An outer right equijoin is a join where every member of the second sequence is included in the output sequence, even if the first sequence doesn't include a match. +.NET 10 includes [`LeftJoin`](/dotnet/api/?term=LeftJoin) and [`RightJoin`](/dotnet/api/?term=RightJoin) methods in the and classes. These methods perform an *outer left equijoin*, and an *outer right equijoin*, respectively. An outer left equijoin is a join where every member of the first sequence is included in the output sequence, even if the second sequence doesn't include a match. An outer right equijoin is a join where every member of the second sequence is included in the output sequence, even if the first sequence doesn't include a match. ## Emulate a left outer join diff --git a/docs/framework/configure-apps/file-schema/appsettings/add-element-for-appsettings.md b/docs/framework/configure-apps/file-schema/appsettings/add-element-for-appsettings.md index 567d5dc5ac878..9af7bc0527b46 100644 --- a/docs/framework/configure-apps/file-schema/appsettings/add-element-for-appsettings.md +++ b/docs/framework/configure-apps/file-schema/appsettings/add-element-for-appsettings.md @@ -7,7 +7,6 @@ f1_keywords: helpviewer_keywords: - "add Element" - " Element" -ms.assetid: 8734efdc-00f6-4a65-bba6-084c5bc65246 --- # `` element for \ @@ -27,16 +26,16 @@ Adds a custom application setting. ## Attributes -| | Description | -| --------- | ----------- | -| `key` | Required attribute.

Specifies the name of the key to add. | -| `value` | Required attribute.

Specifies the value of the key to add. | +| Attribute | Description | +|-----------|-------------------------------------------------------------------| +| `key` | Required attribute.

Specifies the name of the key to add. | +| `value` | Required attribute.

Specifies the value of the key to add. | ## Parent element -| | Description | -| --- | ----------- | -| [**\**](appsettings-element-for-configuration.md) | Contains custom application settings, such as file paths, XML Web service URLs, or any other custom configuration information for an application. | +| Parent element | Description | +|-------------------------------------------------------------|-------------| +| [``](appsettings-element-for-configuration.md) | Contains custom application settings, such as file paths, XML Web service URLs, or any other custom configuration information for an application. | ## Child elements diff --git a/docs/framework/configure-apps/file-schema/appsettings/appsettings-element-for-configuration.md b/docs/framework/configure-apps/file-schema/appsettings/appsettings-element-for-configuration.md index 4f69e3b78abd8..8bf38c545f777 100644 --- a/docs/framework/configure-apps/file-schema/appsettings/appsettings-element-for-configuration.md +++ b/docs/framework/configure-apps/file-schema/appsettings/appsettings-element-for-configuration.md @@ -7,7 +7,6 @@ f1_keywords: helpviewer_keywords: - "appSettings Element" - " Element" -ms.assetid: 39694cc4-6b84-45a6-9329-385a0d8b48fe --- # `` element for \ @@ -26,20 +25,20 @@ Contains custom application settings. This is a predefined configuration section ## Attribute -| | Description | +| Attribute | Description | | --------- | ----------- | -| `file` | Optional attribute.

Specifies a relative path to an external file containing custom application configuration settings. The specified file contains the same kind of settings that are specified in the ``, ``, and `` elements and uses the same key/value pair format as those elements.

The path specified is relative to the main configuration file. For a Windows Forms application, this is the binary folder (such as */bin/debug*), not the location of the application configuration file. For Web Forms applications, the path is relative to the application root, where the *web.config* file is located.

The runtime ignores the attribute if the specified file can't be found. | +| `file` | Optional attribute.

Specifies a relative path to an external file containing custom application configuration settings. The specified file contains the same kind of settings that are specified in the ``, ``, and `` elements and uses the same key/value pair format as those elements.

The path specified is relative to the main configuration file. For a Windows Forms application, this is the binary folder (such as */bin/debug*), not the location of the application configuration file. For Web Forms applications, the path is relative to the application root, where the *web.config* file is located.

The runtime ignores the attribute if the specified file can't be found. | ## Parent element -| | Description | -| --- | ----------- | -| [`` Element](../configuration-element.md) | The root element in every configuration file used by the common language runtime and .NET Framework applications. | +| Parent element | Description | +|--------------------------------------------------|-------------| +| [``](../configuration-element.md) | The root element in every configuration file used by the common language runtime and .NET Framework applications. | ## Child elements -| | Description | -| --- | ----------- | +| Child element | Description | +|----------------------------------------------|------------------------------------| | [**\**](add-element-for-appsettings.md) | Adds a custom application setting. | | [**\**](clear-element-for-appsettings.md) | Clears all previously defined application settings. | | [**\**](remove-element-for-appsettings.md) | Removes a previously defined application setting. | diff --git a/docs/framework/configure-apps/file-schema/appsettings/remove-element-for-appsettings.md b/docs/framework/configure-apps/file-schema/appsettings/remove-element-for-appsettings.md index 8c6f8de351461..bc7f71f7c943e 100644 --- a/docs/framework/configure-apps/file-schema/appsettings/remove-element-for-appsettings.md +++ b/docs/framework/configure-apps/file-schema/appsettings/remove-element-for-appsettings.md @@ -7,7 +7,6 @@ f1_keywords: helpviewer_keywords: - "remove Element" - " Element" -ms.assetid: 218c4464-e007-4539-803f-7c8b0a909fd8 --- # `` element for `` @@ -27,15 +26,15 @@ Removes custom application settings. ### Attribute -| | Description | -| ------- | ----------- | -| `key` | Required attribute.

Specifies the name of the key to remove. | +| Attribute | Description | +|-----------|---------------------------------------------------------------------| +| `key` | Required attribute.

Specifies the name of the key to remove. | ### Parent element -| | Description | -| --- | ----------- | -| [**\**](appsettings-element-for-configuration.md) | Contains custom application settings, such as file paths, XML Web service URLs, or any other custom configuration information for an application. | +| Parent element | Description | +|-------------------------------------------------------------|-------------| +| [``](appsettings-element-for-configuration.md) | Contains custom application settings, such as file paths, XML Web service URLs, or any other custom configuration information for an application. | ## Child elements diff --git a/docs/framework/configure-apps/file-schema/assemblybinding-element-for-configuration.md b/docs/framework/configure-apps/file-schema/assemblybinding-element-for-configuration.md index d620473a1f936..9d1164af5892a 100644 --- a/docs/framework/configure-apps/file-schema/assemblybinding-element-for-configuration.md +++ b/docs/framework/configure-apps/file-schema/assemblybinding-element-for-configuration.md @@ -7,7 +7,6 @@ f1_keywords: helpviewer_keywords: - "assemblyBinding Element" - " Element" -ms.assetid: 6cc55983-b894-449b-8e26-b258e53939cd --- # `` element for \ @@ -27,21 +26,21 @@ Specifies assembly binding policy at the configuration level. ## Attribute -| | Description | -| --------- | ----------- | -| `xmlns` | Required attribute.

Specifies the XML namespace required for assembly binding. Use the string "urn:schemas-microsoft-com:asm.v1" as the value. | +| Attribute | Description | +|-----------|-------------| +| `xmlns` | Required attribute.

Specifies the XML namespace required for assembly binding. Use the string "urn:schemas-microsoft-com:asm.v1" as the value. | ## Parent element -| | Description | -| --- | ----------- | -| [**\**](configuration-element.md) | The root element in every configuration file used by the common language runtime and .NET Framework applications. | +| Parent element | Description | +|-----------------------------------------------|-------------| +| [``](configuration-element.md) | The root element in every configuration file used by the common language runtime and .NET Framework applications. | ## Child element -| | Description | -| --- | ----------- | -| [**\**](linkedconfiguration-element.md) | Specifies a configuration file to include. | +| Child element | Description | +|-----------------------------------------------------------|--------------------------------------------| +| [``](linkedconfiguration-element.md) | Specifies a configuration file to include. | ## Remarks diff --git a/docs/framework/configure-apps/file-schema/clear-element-for-custom-2.md b/docs/framework/configure-apps/file-schema/clear-element-for-custom-2.md index ebe69e619842d..178ddcd3a3477 100644 --- a/docs/framework/configure-apps/file-schema/clear-element-for-custom-2.md +++ b/docs/framework/configure-apps/file-schema/clear-element-for-custom-2.md @@ -29,9 +29,9 @@ None ## Parent element -| | Description | -| --- | ------------| -| [`` Element](custom-element-2.md) | Defines settings for custom configuration sections that use the and classes. | +| Parent element | Description | +|----------------------------------------|-------------| +| [``](custom-element-2.md) | Defines settings for custom configuration sections that use the and classes. | ## Child elements diff --git a/docs/framework/configure-apps/file-schema/configuration-sections-schema.md b/docs/framework/configure-apps/file-schema/configuration-sections-schema.md index d3973fee0340a..4c1cc44cc92f9 100644 --- a/docs/framework/configure-apps/file-schema/configuration-sections-schema.md +++ b/docs/framework/configure-apps/file-schema/configuration-sections-schema.md @@ -9,7 +9,6 @@ helpviewer_keywords: - "custom elements" - "configuration schema [.NET Framework], custom settings in configuration files" - "elements [.NET Framework], custom settings in configuration files" -ms.assetid: 6e4cc793-c526-4007-b4e9-37d56295f2cb --- # Configuration sections schema @@ -20,17 +19,15 @@ The configuration sections schema contains elements that define custom settings [**\
**](section-element.md) [**\**](sectiongroup-element-for-configsections.md) -| | Description | +| Element | Description | | --- | ----------- | -| [**\**](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. | +| [``](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. | | [`
` for `` and ``](section-element.md) | Contains a configuration section declaration. | | [`` for ``](sectiongroup-element-for-configsections.md) | Defines a namespace for configuration sections. | - - ## Unimplemented elements The following elements have no impact and should not be used: -* **\** -* **\** +* `` +* `` diff --git a/docs/framework/configure-apps/file-schema/remove-element-for-custom-2.md b/docs/framework/configure-apps/file-schema/remove-element-for-custom-2.md index 89ca2255a1819..7e147f3291158 100644 --- a/docs/framework/configure-apps/file-schema/remove-element-for-custom-2.md +++ b/docs/framework/configure-apps/file-schema/remove-element-for-custom-2.md @@ -7,7 +7,6 @@ f1_keywords: helpviewer_keywords: - "remove Element" - " Element" -ms.assetid: 8d8af7f5-26c9-4db9-bbe4-b2a4e6949568 --- # `` element for NameValueSectionHandler and DictionarySectionHandler @@ -25,15 +24,15 @@ Removes a previously defined setting. ## Attribute -| | Description | -| --------- | ----------- | -| `key` | Required attribute.

Specifies the name of the setting to remove. | +| Attribute | Description | +|-----------|-------------------------------------------------------------------------| +| `key` | Required attribute.

Specifies the name of the setting to remove. | ## Parent element -| Element | Description | -| ------- | ------------| -| [`` Element](custom-element-2.md) | Defines settings for custom configuration sections that use the and classes. | +| Element | Description | +|----------------------------------------|-------------| +| [``](custom-element-2.md) | Defines settings for custom configuration sections that use the and classes. | ## Child elements diff --git a/docs/framework/configure-apps/file-schema/section-element.md b/docs/framework/configure-apps/file-schema/section-element.md index c1df5861931c1..e0672f7e69ca4 100644 --- a/docs/framework/configure-apps/file-schema/section-element.md +++ b/docs/framework/configure-apps/file-schema/section-element.md @@ -34,26 +34,26 @@ Contains a configuration section declaration. ## Required attributes -| | Description | -| --------- | ----------- | -| `name` | Specifies the name of the configuration section. | -| `type` | Specifies the name of the configuration section handler class that reads the section from the configuration file. The type value has the syntax "fully-qualified-section-handler-class-name, simple-assembly-name". The simple assembly name is the root filename without the *.dll* file extension. | +| Attribute | Description | +|-----------|--------------------------------------------------| +| `name` | Specifies the name of the configuration section. | +| `type` | Specifies the name of the configuration section handler class that reads the section from the configuration file. The type value has the syntax "fully-qualified-section-handler-class-name, simple-assembly-name". The simple assembly name is the root filename without the *.dll* file extension. | ## Optional attributes The following attributes are applicable only for ASP.NET applications. The configuration system ignores these attributes for other application types. -| | Description | -| ------------------- | ----------- | +| Attribute | Description | +| ----------------- | ----------- | | `allowDefinition` | Specifies which configuration file the section can be used in. Use one of the following values:

**Everywhere**
Allows the section to be used in any configuration file. This is the default.
**MachineOnly**
Allows the section to be used only in the machine configuration file (*Machine.config*).
**MachineToApplication**
Allows the section to be used in the machine configuration file or the application configuration file. | | `allowLocation` | Determines whether the section can be used within the `` element. Use one of the following values:

**true**
Allows the section to be used within the `` element. This is the default.
**false**
Does not allow the section to be used within the `` element. | ## Parent elements -| | Description | -| --- | ----------- | -| [`` Element](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. | -| [`` Element](sectiongroup-element-for-configsections.md) | Defines a namespace for configuration sections. | +| Parent element | Description | +| ----------------------------------------------------------------- | ----------- | +| [``](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. | +| [``](sectiongroup-element-for-configsections.md) | Defines a namespace for configuration sections. | > [!NOTE] > A `
` element is a child element of either `` or `` but not both. diff --git a/docs/framework/configure-apps/file-schema/sectiongroup-element-for-configsections.md b/docs/framework/configure-apps/file-schema/sectiongroup-element-for-configsections.md index d522755039ba1..9d7fd2cbdd152 100644 --- a/docs/framework/configure-apps/file-schema/sectiongroup-element-for-configsections.md +++ b/docs/framework/configure-apps/file-schema/sectiongroup-element-for-configsections.md @@ -27,21 +27,21 @@ Defines a namespace for configuration sections. ## Attribute -| | Description | -| --------- | ----------- | -| `name` | Required attribute.

Specifies the name of the section group you are defining. | +| Attribute | Description | +|-----------|-------------------------------------------------------------------------------------| +| `name` | Required attribute.

Specifies the name of the section group you're defining. | ## Parent element -| | Description | -| --- | ----------- | -| [`` Element](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. | +| Parent element | Description | +|-------------------------------------------------------------------|-------------| +| [``](configsections-element-for-configuration.md) | Contains configuration section and namespace declarations. | ## Child elements -| | Description | -| --- | ----------- | -| [**\
**](section-element.md) | Contains a configuration section declaration. | +| Child element | Description | +|-----------------------------------|-----------------------------------------------| +| [`
`](section-element.md) | Contains a configuration section declaration. | ## Remarks diff --git a/docs/orleans/deployment/handling-failures.md b/docs/orleans/deployment/handling-failures.md index 7e1f2864d40e0..e58e62baea572 100644 --- a/docs/orleans/deployment/handling-failures.md +++ b/docs/orleans/deployment/handling-failures.md @@ -2,7 +2,7 @@ title: Failure handling description: Learn how to handle failures in Orleans apps. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Failure handling diff --git a/docs/orleans/grains/code-generation.md b/docs/orleans/grains/code-generation.md index a1ffacc329466..b0e4f521cd154 100644 --- a/docs/orleans/grains/code-generation.md +++ b/docs/orleans/grains/code-generation.md @@ -2,7 +2,7 @@ title: Code generation description: Learn how to use code generation in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article zone_pivot_groups: orleans-version --- diff --git a/docs/orleans/grains/event-sourcing/event-sourcing-configuration.md b/docs/orleans/grains/event-sourcing/event-sourcing-configuration.md index 05cea341fc997..ae4ba91a2d587 100644 --- a/docs/orleans/grains/event-sourcing/event-sourcing-configuration.md +++ b/docs/orleans/grains/event-sourcing/event-sourcing-configuration.md @@ -2,7 +2,7 @@ title: Event sourcing configuration description: Learn about event sourcing configuration in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Event sourcing configuration diff --git a/docs/orleans/grains/event-sourcing/immediate-vs-delayed-confirmation.md b/docs/orleans/grains/event-sourcing/immediate-vs-delayed-confirmation.md index c91a6d2e0d9b8..57bd54ea46a37 100644 --- a/docs/orleans/grains/event-sourcing/immediate-vs-delayed-confirmation.md +++ b/docs/orleans/grains/event-sourcing/immediate-vs-delayed-confirmation.md @@ -2,7 +2,7 @@ title: Immediate and delayed confirmation description: Learn the differences between immediate and delayed confirmation in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Immediate and delayed confirmations diff --git a/docs/orleans/grains/event-sourcing/journaledgrain-basics.md b/docs/orleans/grains/event-sourcing/journaledgrain-basics.md index a7b6bf77daeff..b33ade55d6313 100644 --- a/docs/orleans/grains/event-sourcing/journaledgrain-basics.md +++ b/docs/orleans/grains/event-sourcing/journaledgrain-basics.md @@ -2,7 +2,7 @@ title: The JournaledGrain API description: Learn the concepts of the JournaledGrain API in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # JournaledGrain basics diff --git a/docs/orleans/grains/event-sourcing/journaledgrain-diagnostics.md b/docs/orleans/grains/event-sourcing/journaledgrain-diagnostics.md index 7e1e8f016ccd6..cbaa3c254ffd1 100644 --- a/docs/orleans/grains/event-sourcing/journaledgrain-diagnostics.md +++ b/docs/orleans/grains/event-sourcing/journaledgrain-diagnostics.md @@ -2,7 +2,7 @@ title: JournaledGrain diagnostics description: Learn how to use JournaledGrain diagnostics in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # JournaledGrain diagnostics diff --git a/docs/orleans/grains/event-sourcing/log-consistency-providers.md b/docs/orleans/grains/event-sourcing/log-consistency-providers.md index 60540a4e3fe6a..350af23925928 100644 --- a/docs/orleans/grains/event-sourcing/log-consistency-providers.md +++ b/docs/orleans/grains/event-sourcing/log-consistency-providers.md @@ -2,7 +2,7 @@ title: Log-consistency providers description: Learn about log-consistency providers in .NET Orleans. ms.date: 03/29/2025 -ms.topic: conceptual +ms.topic: article --- # Log-consistency providers diff --git a/docs/orleans/grains/event-sourcing/notifications.md b/docs/orleans/grains/event-sourcing/notifications.md index 47c30e0dfb70a..e746e316ae14f 100644 --- a/docs/orleans/grains/event-sourcing/notifications.md +++ b/docs/orleans/grains/event-sourcing/notifications.md @@ -2,7 +2,7 @@ title: Notifications description: Learn the concepts of notifications in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Notifications diff --git a/docs/orleans/grains/event-sourcing/replicated-instances.md b/docs/orleans/grains/event-sourcing/replicated-instances.md index 6a1994dd3d175..790375efbfa0e 100644 --- a/docs/orleans/grains/event-sourcing/replicated-instances.md +++ b/docs/orleans/grains/event-sourcing/replicated-instances.md @@ -2,7 +2,7 @@ title: Replicated grains description: Learn the concepts of replicated grains in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Replicated grains diff --git a/docs/orleans/grains/external-tasks-and-grains.md b/docs/orleans/grains/external-tasks-and-grains.md index 24a4a58df4697..d7c9fd76a8b3c 100644 --- a/docs/orleans/grains/external-tasks-and-grains.md +++ b/docs/orleans/grains/external-tasks-and-grains.md @@ -2,7 +2,7 @@ title: External tasks and grains description: Learn about external tasks and grains in .NET Orleans. ms.date: 03/31/2025 -ms.topic: conceptual +ms.topic: article --- # External tasks and grains diff --git a/docs/orleans/grains/grain-extensions.md b/docs/orleans/grains/grain-extensions.md index 5a35ddd6e7230..c843e8e4ce39e 100644 --- a/docs/orleans/grains/grain-extensions.md +++ b/docs/orleans/grains/grain-extensions.md @@ -2,7 +2,7 @@ title: Grain extensions description: Learn how to extend an Orleans Grain. ms.date: 03/31/2025 -ms.topic: conceptual +ms.topic: article --- # Grain extensions diff --git a/docs/orleans/grains/grain-identity.md b/docs/orleans/grains/grain-identity.md index f0a630aa39a4f..1801895e07b1e 100644 --- a/docs/orleans/grains/grain-identity.md +++ b/docs/orleans/grains/grain-identity.md @@ -2,7 +2,7 @@ title: Grain identity description: Learn about grain identities in .NET Orleans. ms.date: 03/31/2025 -ms.topic: conceptual +ms.topic: article --- # Grain identity diff --git a/docs/orleans/grains/grain-lifecycle.md b/docs/orleans/grains/grain-lifecycle.md index 61ebf048e2280..fb0d817fcd321 100644 --- a/docs/orleans/grains/grain-lifecycle.md +++ b/docs/orleans/grains/grain-lifecycle.md @@ -2,7 +2,7 @@ title: Grain lifecycle overview description: Learn about grain lifecycles in .NET Orleans. ms.date: 03/31/2025 -ms.topic: conceptual +ms.topic: article zone_pivot_groups: orleans-version --- diff --git a/docs/orleans/grains/grain-placement.md b/docs/orleans/grains/grain-placement.md index 97edb2eea4003..437c023517fd0 100644 --- a/docs/orleans/grains/grain-placement.md +++ b/docs/orleans/grains/grain-placement.md @@ -2,7 +2,7 @@ title: Grain placement description: Learn about grain placement in .NET Orleans. ms.date: 03/31/2025 -ms.topic: conceptual +ms.topic: article --- # Grain placement diff --git a/docs/orleans/grains/grain-references.md b/docs/orleans/grains/grain-references.md index 5443606b45998..902c5ce852bdb 100644 --- a/docs/orleans/grains/grain-references.md +++ b/docs/orleans/grains/grain-references.md @@ -2,7 +2,7 @@ title: Grain references description: Learn about grain references in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Grain references diff --git a/docs/orleans/grains/grain-versioning/backward-compatibility-guidelines.md b/docs/orleans/grains/grain-versioning/backward-compatibility-guidelines.md index 22e559cdcbbfd..c771be0b5978e 100644 --- a/docs/orleans/grains/grain-versioning/backward-compatibility-guidelines.md +++ b/docs/orleans/grains/grain-versioning/backward-compatibility-guidelines.md @@ -2,7 +2,7 @@ title: Backward compatibility guidelines description: Learn the backward compatibility guidelines in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Backward compatibility guidelines diff --git a/docs/orleans/grains/grain-versioning/compatible-grains.md b/docs/orleans/grains/grain-versioning/compatible-grains.md index b9d06a7513bd8..400a4670b83ee 100644 --- a/docs/orleans/grains/grain-versioning/compatible-grains.md +++ b/docs/orleans/grains/grain-versioning/compatible-grains.md @@ -2,7 +2,7 @@ title: Compatible grains description: Learn about compatible grains in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Compatible grains diff --git a/docs/orleans/grains/grain-versioning/grain-versioning.md b/docs/orleans/grains/grain-versioning/grain-versioning.md index 0fe24a91d21cb..fa12d91976c56 100644 --- a/docs/orleans/grains/grain-versioning/grain-versioning.md +++ b/docs/orleans/grains/grain-versioning/grain-versioning.md @@ -2,7 +2,7 @@ title: Grain interface versioning description: Learn how to use grain interface versioning in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Grain interface versioning diff --git a/docs/orleans/grains/grain-versioning/version-selector-strategy.md b/docs/orleans/grains/grain-versioning/version-selector-strategy.md index 03d50eb825b8e..1d96475e62d0a 100644 --- a/docs/orleans/grains/grain-versioning/version-selector-strategy.md +++ b/docs/orleans/grains/grain-versioning/version-selector-strategy.md @@ -2,7 +2,7 @@ title: Version selector strategy description: Learn how to use the version selector strategy in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Version selector strategy diff --git a/docs/orleans/grains/grainservices.md b/docs/orleans/grains/grainservices.md index 9d48ba257c914..a28d05747980f 100644 --- a/docs/orleans/grains/grainservices.md +++ b/docs/orleans/grains/grainservices.md @@ -2,7 +2,7 @@ title: Create a GrainService description: Learn how to create a GrainService in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article zone_pivot_groups: orleans-version --- diff --git a/docs/orleans/grains/index.md b/docs/orleans/grains/index.md index 68d21f1f5351b..4d6353ba4508a 100644 --- a/docs/orleans/grains/index.md +++ b/docs/orleans/grains/index.md @@ -2,7 +2,7 @@ title: Develop a grain description: Learn how to develop a grain in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Develop a grain diff --git a/docs/orleans/grains/interceptors.md b/docs/orleans/grains/interceptors.md index 2e6a731367e0e..95dc50acf08b2 100644 --- a/docs/orleans/grains/interceptors.md +++ b/docs/orleans/grains/interceptors.md @@ -2,7 +2,7 @@ title: Grain call filters description: Learn about grain call filters in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Grain call filters diff --git a/docs/orleans/grains/observers.md b/docs/orleans/grains/observers.md index 45292a3f7865a..4d409b3723b15 100644 --- a/docs/orleans/grains/observers.md +++ b/docs/orleans/grains/observers.md @@ -2,7 +2,7 @@ title: Observers description: Learn about observers in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Observers diff --git a/docs/orleans/grains/oneway.md b/docs/orleans/grains/oneway.md index bd71fc586827d..9dd54918a75c5 100644 --- a/docs/orleans/grains/oneway.md +++ b/docs/orleans/grains/oneway.md @@ -2,7 +2,7 @@ title: One-way requests description: Learn about one-way requests in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # One-way requests diff --git a/docs/orleans/grains/request-context.md b/docs/orleans/grains/request-context.md index 63d1e7189137e..537e10a4baeb5 100644 --- a/docs/orleans/grains/request-context.md +++ b/docs/orleans/grains/request-context.md @@ -2,7 +2,7 @@ title: Request context description: Learn about request context in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Request context @@ -62,8 +62,8 @@ public class HelloGrain(ILogger logger) : Grain, IHelloGrain SayHello message received: greeting = "{Greeting}" """, greeting); - - var traceId = RequestContext.Get("TraceId") as string + + var traceId = RequestContext.Get("TraceId") as string ?? "No trace ID"; return ValueTask.FromResult($""" diff --git a/docs/orleans/grains/request-scheduling.md b/docs/orleans/grains/request-scheduling.md index 2346c88a69393..b2ceb88b671d9 100644 --- a/docs/orleans/grains/request-scheduling.md +++ b/docs/orleans/grains/request-scheduling.md @@ -2,7 +2,7 @@ title: Request scheduling description: Learn about request scheduling in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Request scheduling diff --git a/docs/orleans/grains/stateless-worker-grains.md b/docs/orleans/grains/stateless-worker-grains.md index 9c328cf75a39c..2817515c60b84 100644 --- a/docs/orleans/grains/stateless-worker-grains.md +++ b/docs/orleans/grains/stateless-worker-grains.md @@ -2,7 +2,7 @@ title: Stateless worker grains description: Learn how to use stateless worker grains in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Stateless worker grains diff --git a/docs/orleans/grains/timers-and-reminders.md b/docs/orleans/grains/timers-and-reminders.md index 5b11631cd0d54..092145a30e68c 100644 --- a/docs/orleans/grains/timers-and-reminders.md +++ b/docs/orleans/grains/timers-and-reminders.md @@ -2,7 +2,7 @@ title: Timers and reminders description: Learn how to use timers and reminders in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article ms.custom: sfi-ropc-nochange --- diff --git a/docs/orleans/grains/transactions.md b/docs/orleans/grains/transactions.md index 16692735105db..7a8cfcb4bd42a 100644 --- a/docs/orleans/grains/transactions.md +++ b/docs/orleans/grains/transactions.md @@ -2,7 +2,7 @@ title: Transactions in Orleans description: Learn how to use transactions in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Orleans transactions diff --git a/docs/orleans/host/client.md b/docs/orleans/host/client.md index 1ab9796a04e20..5724fa0064485 100644 --- a/docs/orleans/host/client.md +++ b/docs/orleans/host/client.md @@ -2,7 +2,7 @@ title: Orleans clients description: Learn how to write .NET Orleans clients. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article zone_pivot_groups: orleans-version ms.custom: sfi-ropc-nochange --- @@ -73,7 +73,7 @@ Provide configuration via @@ -250,7 +250,7 @@ await Host.CreateDefaultBuilder(args) { builder.UseLocalhostClustering(); }) - .ConfigureServices(services => + .ConfigureServices(services => { services.AddHostedService(); }) @@ -330,7 +330,7 @@ static async Task RunWatcherAsync() Console.WriteLine( "Subscribed successfully. Press to stop."); - Console.ReadLine(); + Console.ReadLine(); } catch (Exception e) { diff --git a/docs/orleans/host/configuration-guide/activation-collection.md b/docs/orleans/host/configuration-guide/activation-collection.md index 0df3a53d9a1c4..fca557160f33d 100644 --- a/docs/orleans/host/configuration-guide/activation-collection.md +++ b/docs/orleans/host/configuration-guide/activation-collection.md @@ -2,7 +2,7 @@ title: Activation collection description: Learn about activation collection in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article zone_pivot_groups: orleans-version --- diff --git a/docs/orleans/host/configuration-guide/serialization-immutability.md b/docs/orleans/host/configuration-guide/serialization-immutability.md index c8943cfce5c79..95ad4c65f8adc 100644 --- a/docs/orleans/host/configuration-guide/serialization-immutability.md +++ b/docs/orleans/host/configuration-guide/serialization-immutability.md @@ -2,7 +2,7 @@ title: Serialization of immutable types in Orleans description: Learn how .NET Orleans handles type immutability in the context of serialization. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Serialization of immutable types in Orleans @@ -62,7 +62,7 @@ Sometimes, you might not control the object; for example, it might be a `List ReferenceData { get; set; } - + [Id(1)] public List RunningTotals { get; set; } } diff --git a/docs/orleans/host/grain-directory.md b/docs/orleans/host/grain-directory.md index 8d156fc767eb5..6754f360c4062 100644 --- a/docs/orleans/host/grain-directory.md +++ b/docs/orleans/host/grain-directory.md @@ -2,7 +2,7 @@ title: Grain directory description: Learn about the grain directory in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article ms.custom: sfi-ropc-nochange --- diff --git a/docs/orleans/host/powershell-client.md b/docs/orleans/host/powershell-client.md index c53f7fb2e3bcf..550bbabb6ceb7 100644 --- a/docs/orleans/host/powershell-client.md +++ b/docs/orleans/host/powershell-client.md @@ -2,7 +2,7 @@ title: PowerShell client module description: Learn about the PowerShell client module in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # PowerShell client module diff --git a/docs/orleans/implementation/cluster-management.md b/docs/orleans/implementation/cluster-management.md index f3036399c7c7b..ce01f6b56ce97 100644 --- a/docs/orleans/implementation/cluster-management.md +++ b/docs/orleans/implementation/cluster-management.md @@ -2,7 +2,7 @@ title: Cluster management in Orleans description: Learn about cluster management in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Cluster management in Orleans diff --git a/docs/orleans/implementation/grain-directory.md b/docs/orleans/implementation/grain-directory.md index 669d856a07f1b..1595acb0d619c 100644 --- a/docs/orleans/implementation/grain-directory.md +++ b/docs/orleans/implementation/grain-directory.md @@ -2,7 +2,7 @@ title: Grain Directory Implementation description: Explore the implementation of the grain directory in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Grain directory implementation diff --git a/docs/orleans/implementation/load-balancing.md b/docs/orleans/implementation/load-balancing.md index e19970df48feb..e8033c4c40de5 100644 --- a/docs/orleans/implementation/load-balancing.md +++ b/docs/orleans/implementation/load-balancing.md @@ -2,7 +2,7 @@ title: Load balancing description: Learn how .NET Orleans manages load balancing. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Load balancing diff --git a/docs/orleans/implementation/messaging-delivery-guarantees.md b/docs/orleans/implementation/messaging-delivery-guarantees.md index 35edac8e96297..e81750240a1a7 100644 --- a/docs/orleans/implementation/messaging-delivery-guarantees.md +++ b/docs/orleans/implementation/messaging-delivery-guarantees.md @@ -2,7 +2,7 @@ title: Messaging delivery guarantees description: Learn about messaging delivery guarantees in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Messaging delivery guarantees diff --git a/docs/orleans/implementation/orleans-lifecycle.md b/docs/orleans/implementation/orleans-lifecycle.md index f981027467d33..ec64f1211832c 100644 --- a/docs/orleans/implementation/orleans-lifecycle.md +++ b/docs/orleans/implementation/orleans-lifecycle.md @@ -2,7 +2,7 @@ title: Orleans lifecycle description: Learn the various lifecycles of .NET Orleans apps. ms.date: 03/30/2025 -ms.topic: conceptual +ms.topic: article --- # Orleans lifecycle overview diff --git a/docs/orleans/implementation/scheduler.md b/docs/orleans/implementation/scheduler.md index b7b257e1e15d4..f88ba089dac75 100644 --- a/docs/orleans/implementation/scheduler.md +++ b/docs/orleans/implementation/scheduler.md @@ -2,7 +2,7 @@ title: Scheduling overview description: Explore the scheduling overview in .NET Orleans. ms.date: 03/30/2025 -ms.topic: conceptual +ms.topic: article --- # Scheduling overview diff --git a/docs/orleans/implementation/streams-implementation/azure-queue-streams.md b/docs/orleans/implementation/streams-implementation/azure-queue-streams.md index 0d89846c9195f..d4621a028f356 100644 --- a/docs/orleans/implementation/streams-implementation/azure-queue-streams.md +++ b/docs/orleans/implementation/streams-implementation/azure-queue-streams.md @@ -2,7 +2,7 @@ title: Azure Queue streams overview description: Explore the streaming implementation with Azure Queue in .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article --- # Azure Queue streams overview diff --git a/docs/orleans/streaming/stream-providers.md b/docs/orleans/streaming/stream-providers.md index 2541f4f2f5ac0..4a75881807542 100644 --- a/docs/orleans/streaming/stream-providers.md +++ b/docs/orleans/streaming/stream-providers.md @@ -2,7 +2,7 @@ title: Orleans stream providers description: Learn about the available stream providers for .NET Orleans. ms.date: 05/23/2025 -ms.topic: conceptual +ms.topic: article zone_pivot_groups: orleans-version --- diff --git a/docs/orleans/streaming/streams-programming-apis.md b/docs/orleans/streaming/streams-programming-apis.md index 369efe3185740..aba1693a58af5 100644 --- a/docs/orleans/streaming/streams-programming-apis.md +++ b/docs/orleans/streaming/streams-programming-apis.md @@ -2,7 +2,7 @@ title: Orleans streaming APIs description: Learn about the available streaming APIs for .NET Orleans. ms.date: 03/30/2025 -ms.topic: conceptual +ms.topic: article zone_pivot_groups: orleans-version ms.custom: sfi-ropc-nochange --- diff --git a/docs/orleans/streaming/streams-why.md b/docs/orleans/streaming/streams-why.md index 32aa6074ffa02..eb6072dea99e6 100644 --- a/docs/orleans/streaming/streams-why.md +++ b/docs/orleans/streaming/streams-why.md @@ -2,7 +2,7 @@ title: Why streams in Orleans? description: Learn why you'd want to use streams in .NET Orleans. ms.date: 03/30/2025 -ms.topic: conceptual +ms.topic: article --- # Why streams in Orleans? diff --git a/docs/standard/commandline/design-guidance.md b/docs/standard/commandline/design-guidance.md index f174862091263..1518987a1164b 100644 --- a/docs/standard/commandline/design-guidance.md +++ b/docs/standard/commandline/design-guidance.md @@ -6,7 +6,7 @@ no-loc: [System.CommandLine] helpviewer_keywords: - "command line" - "System.CommandLine" -ms.topic: conceptual +ms.topic: article --- # Design guidance @@ -33,7 +33,7 @@ Options should provide parameters to commands, rather than specifying actions th ### Short-form aliases -In general, we recommend that you minimize the number of short-form option aliases that you define. +In general, it's best to minimize the number of short-form option aliases that you define. In particular, avoid using any of the following aliases differently than their common usage in the .NET CLI and other .NET command-line apps: