Merge branch 'master' into linq-to-xml

Author: mairaw

.ghal.rules.json

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "configRevision": 1,
+  "configRevision": 2,
 
   "issue": {
     "opened": {
@@ -47,6 +47,9 @@
           },
           "(?i)dotnet-architecture$": {
             "labels-add": ":books: Area - .NET Architecture Guide"
+          },
+          "(?i)azure-dotnet$": {
+            "labels-add": ":books: Area - Azure .NET SDK"
           }
         },
         "technology": {
@@ -133,7 +136,7 @@
           "(?i).*docs\/whats-new\/.*": {
             "labels-add": ":star2: What's New"
           }
-    }
+        }
       },
       "processor-meta-custom": {
         "issuetype": {
@@ -267,6 +270,9 @@
               },
               "(?i).*docs\/whats-new\/.*": {
                 "labels-add": ":star2: What's New"
+              },
+              "(?i).*docs\/azure\/.*": {
+                "labels-add": ":books: Area - Azure .NET SDK"
               }
             }
           }

.github/workflows/markdownlint.yml

@@ -4,9 +4,11 @@ on:
   push:
     paths:
       - "**/*.md"
+      - ".github/workflows/markdownlint.yml"
   pull_request:
     paths:
       - "**/*.md"
+      - ".github/workflows/markdownlint.yml"
 
 jobs:
   lint:

.markdownlint.json

@@ -2,7 +2,6 @@
     "default": true,
     "MD001": false,
     "MD004": false,
-    "MD009": false,
     "MD013": false,
     "MD022": false,
     "MD024": false,

.openpublishing.redirection.json

@@ -89,6 +89,62 @@
       "source_path": "docs/architecture/modernize-with-azure-containers/lift-and-shift-existing-apps-devops/microsoft-technologies-in-cloud-devops-ready-applications.md",
       "redirect_url": "/dotnet/architecture/modernize-with-azure-containers/modernize-existing-apps-to-cloud-optimized/microsoft-technologies-in-cloud-optimized-applications"
     },
+    {
+      "source_path": "docs/azure/dotnet-howto-choose-migration.md",
+      "redirect_url": "/dotnet/azure/migration/choose"
+    },
+    {
+      "source_path": "docs/azure/dotnet-howto-migrate-app-service.md",
+      "redirect_url": "/dotnet/azure/migration/app-service"
+    },
+    {
+      "source_path": "docs/azure/dotnet-howto-migrate-sql.md",
+      "redirect_url": "/dotnet/azure/migration/sql"
+    },
+    {
+      "source_path": "docs/azure/dotnet-howto-migrate-vm.md",
+      "redirect_url": "/dotnet/azure/migration/vm"
+    },
+    {
+      "source_path": "docs/azure/dotnet-quickstart-vs.md",
+      "redirect_url": "/visualstudio/deployment/quickstart-deploy-to-azure?view=vs-2019"
+    },
+    {
+      "source_path": "docs/azure/dotnet-quickstart-xplat.md",
+      "redirect_url": "/azure/app-service/app-service-web-tutorial-dotnetcore-sqldb"
+    },
+    {
+      "source_path": "docs/azure/dotnet-samples.md",
+      "redirect_url": "/dotnet/azure/"
+    },
+    {
+      "source_path": "docs/azure/dotnet-sdk-azure-authenticate.md",
+      "redirect_url": "/dotnet/azure/sdk/authentication"
+    },
+    {
+      "source_path": "docs/azure/dotnet-sdk-azure-concepts.md",
+      "redirect_url": "/dotnet/azure/sdk"
+    },
+    {
+      "source_path": "docs/azure/dotnet-sdk-azure-get-started.md",
+      "redirect_url": "/dotnet/azure/intro"
+    },
+    {
+      "source_path": "docs/azure/dotnet-sdk-azure-overview.md",
+      "redirect_url": "/dotnet/azure/sdk"
+    },
+    {
+      "source_path": "docs/azure/dotnet-sdk-vs2015-install.md",
+      "redirect_url": "/dotnet/azure/sdk/vs2015-install"
+    },
+    {
+      "source_path": "docs/azure/dotnet-tools.md",
+      "redirect_url": "/dotnet/azure/sdk/tools"
+    },
+    {
+      "source_path": "docs/azure/dotnet-tutorials.md",
+      "redirect_url": "/dotnet/azure/"
+    },
     {
       "source_path": "docs/cli-preview3/tools/dotnet-nuget-delete.md",
       "redirect_url": "/dotnet/core/tools/dotnet-nuget-delete"
@@ -163,7 +219,7 @@
     },
     {
       "source_path": "docs/core/install/linux-package-managers.md",
-      "redirect_url": "/dotnet/core/install/linux-package-manager-ubuntu-1904",
+      "redirect_url": "/dotnet/core/install/linux-package-manager-ubuntu-1910",
       "ms.custom": "updateeachrelease"
     },
     {

docfx.json

@@ -45,7 +45,31 @@
         "exclude": [
           "**/README.md",
           "inactive/**",
-          "rejected/**"        ]
+          "rejected/**",
+
+          "csharp-6.0/enum-base-type.md",
+
+          "csharp-7.0/expression-bodied-everything.md",
+          "csharp-7.0/ref-locals-returns.md",
+          "csharp-7.0/tuples.md",
+          "csharp-7.0/value-task.md",
+
+          "csharp-7.2/readonly-struct.md",
+          "csharp-7.2/ref-extension-methods.md",
+          "csharp-7.2/ref-struct-and-span.md",
+
+          "csharp-7.3/enum-delegate-constraints.md",
+          "csharp-7.3/ref-loops.md",
+
+          "csharp-8.0/alternative-interpolated-verbatim.md",
+          "csharp-8.0/async-using.md",
+          "csharp-8.0/constraints-in-overrides.md",
+          "csharp-8.0/constructed-unmanaged.md",
+          "csharp-8.0/notnull-constraint.md",
+          "csharp-8.0/obsolete-accessor.md",
+          "csharp-8.0/shadowing-in-nested-functions.md",
+          "csharp-8.0/unconstrained-null-coalescing.md"
+        ]
       },
       {
         "files": [
@@ -135,6 +159,8 @@
         "docs/framework/xaml-services/**/**.md": "None"
       },
       "feedback_product_url": {
+        "docs/azure/sdk/**/**.md": "https://github.com/azure/azure-sdk-for-net",
+        "docs/azure/sdk/**/**.yml": "https://github.com/azure/azure-sdk-for-net",
         "docs/fsharp/**/**.md": "https://github.com/Microsoft/visualfsharp",
         "docs/machine-learning/**/**.md": "https://github.com/dotnet/machinelearning",
         "docs/standard/data/sqlite/**/*.md": "https://github.com/aspnet/EntityFrameworkCore"
@@ -143,6 +169,8 @@
         "_csharplang/**/*.md": "dotnet-csharp",
         "_vblang/spec/*.md": "dotnet-visualbasic",
         "docs/architecture/**/**.md": "dotnet-architecture",
+        "docs/azure/**/**.md": "azure-dotnet",
+        "docs/azure/**/**.yml": "azure-dotnet",
         "docs/core/**/**.md": "dotnet-core",
         "docs/csharp/**/**.md": "dotnet-csharp",
         "docs/csharp/**/**.yml": "dotnet-csharp",
@@ -158,6 +186,7 @@
       "ms.topic": {
         "_csharplang/**/*.md": "language-reference",
         "_vblang/spec/*.md": "language-reference",
+        "docs/azure/**/**.md": "conceptual",
         "docs/csharp/language-reference/**/**.md": "language-reference",
         "docs/framework/additional-apis/**/**.md": "managed-reference",
         "docs/framework/unmanaged-api/**/**.md": "reference",
@@ -174,6 +203,8 @@
         "docs/visual-basic/**/**.md": "vb"
       },
       "author": {
+        "docs/azure/**/**.md": "camsoper",
+        "docs/azure/**/**.yml": "camsoper",
         "docs/architecture/**/**.md": "nishanil",
         "docs/architecture/grpc-for-wcf-developers/**/**.md": "shirhatti",
         "docs/core/**/**.md": "tdykstra",
@@ -260,6 +291,8 @@
         "_vblang/spec/*.md": "wiwagn",
         "docs/architecture/**/**.md": "nanil",
         "docs/architecture/grpc-for-wcf-developers/**/**.md": "soshir",
+        "docs/azure/**/**.md": "casoper",
+        "docs/azure/**/**.yml": "casoper",
         "docs/core/**/**.md": "dotnetcontent",
         "docs/core/compatibility/**/**.md": "gewarren",
         "docs/core/deploying/**/**.md": "adegeo",

docs/architecture/blazor-for-web-forms-developers/components.md

@@ -49,7 +49,7 @@ Or you can generate a list of items using a normal C# `foreach` loop like this:
 <ul>
 @foreach (var item in items)
 {
-    <li>item.Text</li>
+    <li>@item.Text</li>
 }
 </ul>
 ```

docs/architecture/blazor-for-web-forms-developers/migration.md

@@ -577,6 +577,7 @@ The following snippet demonstrates how the Web Forms eShop project uses *web.con
     <add key="UseMockData" value="true" />
     <add key="UseCustomizationData" value="false" />
   </appSettings>
+</configuration>
 ```
 
 It's common for secrets, such as database connection strings, to be stored within the *web.config*. The secrets are inevitably persisted in unsecure locations, such as source control. With Blazor on ASP.NET Core, the preceding XML-based configuration is replaced with the following JSON:

docs/architecture/grpc-for-wcf-developers/protobuf-reserved.md

@@ -6,7 +6,7 @@ ms.date: 09/09/2019
 
 # Protobuf reserved fields
 
-The backward-compatibility guarantees in Protocol Buffer (Protobuf) rely on field numbers always representing the same data item. If a field is removed from a message in a new version of the service, that field number should never be reused. You can enfore this by using the `reserved` keyword.
+The backward-compatibility guarantees in Protocol Buffer (Protobuf) rely on field numbers always representing the same data item. If a field is removed from a message in a new version of the service, that field number should never be reused. You can enforce this by using the `reserved` keyword.
 
 If the `displayName` and `marketId` fields were removed from the `Stock` message defined earlier, their field numbers should be reserved as in the following example.
 

docs/architecture/grpc-for-wcf-developers/rpc-types.md

@@ -120,7 +120,7 @@ In WCF, the [ServiceContract](xref:System.ServiceModel.ServiceContractAttribute)
 
 ## WCF one-way operations and gRPC client streaming
 
-WCF provides one-way operations (marked with `[OperationContract(IsOneWay = true)]`) that return a transport-specific acknowledgement. gRPC service methods always return a response, even if it's empty. The client should always await that response. For the "fire-and-forget" style of messaging in gRPC, you can create a client streaming service.
+WCF provides one-way operations (marked with `[OperationContract(IsOneWay = true)]`) that return a transport-specific acknowledgment. gRPC service methods always return a response, even if it's empty. The client should always await that response. For the "fire-and-forget" style of messaging in gRPC, you can create a client streaming service.
 
 ### thing_log.proto
 

docs/architecture/grpc-for-wcf-developers/self-hosted.md

@@ -102,7 +102,7 @@ ExecStart=/usr/sbin/myapp
 WantedBy=multi-user.target
 ```
 
-The `Type=notify` property tells `systemd` that the application will notify it on startup and shutdown. The `WantedBy=multi-user.target` setting will cause the service to start when the Linux system reaches "runlevel 2," which means a non-graphical multi-user shell is active.
+The `Type=notify` property tells `systemd` that the application will notify it on startup and shutdown. The `WantedBy=multi-user.target` setting will cause the service to start when the Linux system reaches "runlevel 2," which means a non-graphical, multi-user shell is active.
 
 Before `systemd` will recognize the service, it needs to reload its configuration. You control `systemd` by using the `systemctl` command. After reloading, use the `status` subcommand to confirm that the application has registered successfully.
 
@@ -147,7 +147,7 @@ sudo journalctl -u myapp
 > [!TIP]
 > If you have a GUI environment available on your host, a few graphical log viewers are available for Linux, such as *QJournalctl* and *gnome-logs*.
 
-To learn more about querying the `systemd` journal from the command line by using `journalctl`, see [the man pages](https://manpages.debian.org/buster/systemd/journalctl.1).
+To learn more about querying the `systemd` journal from the command line by using `journalctl`, see [the manpages](https://manpages.debian.org/buster/systemd/journalctl.1).
 
 ## HTTPS certificates for self-hosted applications