dotnet · Thraka · Jan 29, 2020 · Jan 27, 2020 · Jan 28, 2020 · Jan 28, 2020
diff --git a/docs/core/install/includes/package-manager-failed-to-fetch-deb.md b/docs/core/install/includes/package-manager-failed-to-fetch-deb.md
@@ -0,0 +1,2 @@
+
+While installing the .NET Core package, you may see an error similar to `Failed to fetch ... File has unexpected size ... Mirror sync in progress?`. Generally speaking, this error means that the package feed for .NET Core is being upgraded with newer package versions, and that you should try again later. During an upgrade, the package feed should not be unavailable for more than 30 minutes. If you continually receive this error for more than 30 minutes, please file an issue at <https://github.com/dotnet/core/issues>.
diff --git a/docs/core/install/includes/package-manager-failed-to-fetch-rpm.md b/docs/core/install/includes/package-manager-failed-to-fetch-rpm.md
@@ -0,0 +1,2 @@
+
+While installing the .NET Core package, you may see an error similar to `signature verification failed for file 'repomd.xml' from repository 'packages-microsoft-com-prod'`. Generally speaking, this error means that the package feed for .NET Core is being upgraded with newer package versions, and that you should try again later. During an upgrade, the package feed should not be unavailable for more than 2 hours. If you continually receive this error for more than 2 hours, please file an issue at <https://github.com/dotnet/core/issues>.
diff --git a/docs/core/install/includes/package-manager-heading-hack-pkgname.md b/docs/core/install/includes/package-manager-heading-hack-pkgname.md
@@ -26,6 +26,6 @@ The version of the SDK or runtime to install. This article will always give the
 - Install the ASP.NET Core 3.1 runtime: `aspnetcore-runtime-3.1`
 - Install the .NET Core 2.1 runtime: `dotnet-runtime-2.1`
 
-### Troubleshoot
+### Package missing
 
-If the package combination doesn't work, it's not available. For example, there isn't an ASP.NET Core SDK, the SDK components are included with the .NET Core SDK. The value `aspnetcore-sdk-2.2` is incorrect and should be `dotnet-sdk-2.2`
+If the package-version combination doesn't work, it's not available. For example, there isn't an ASP.NET Core SDK, the SDK components are included with the .NET Core SDK. The value `aspnetcore-sdk-2.2` is incorrect and should be `dotnet-sdk-2.2`.
diff --git a/docs/core/install/linux-package-manager-centos7.md b/docs/core/install/linux-package-manager-centos7.md
@@ -55,3 +55,11 @@ sudo yum install dotnet-runtime-3.1
 ## How to install other versions
 
 [!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]
+
+## Troubleshoot the package manager
+
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-rpm](includes/package-manager-failed-to-fetch-rpm.md)]
diff --git a/docs/core/install/linux-package-manager-debian10.md b/docs/core/install/linux-package-manager-debian10.md
@@ -69,3 +69,11 @@ sudo apt-get install dotnet-runtime-3.1
 ## How to install other versions
 
 [!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]
+
+## Troubleshoot the package manager
+
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-deb](includes/package-manager-failed-to-fetch-deb.md)]
diff --git a/docs/core/install/linux-package-manager-debian9.md b/docs/core/install/linux-package-manager-debian9.md
@@ -69,3 +69,11 @@ sudo apt-get install dotnet-runtime-3.1
 ## How to install other versions
 
 [!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]
+
+## Troubleshoot the package manager
+
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-deb](includes/package-manager-failed-to-fetch-deb.md)]
diff --git a/docs/core/install/linux-package-manager-fedora29.md b/docs/core/install/linux-package-manager-fedora29.md
@@ -56,3 +56,11 @@ sudo dnf install dotnet-runtime-3.1
 ## How to install other versions
 
 [!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]
+
+## Troubleshoot the package manager
+
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-rpm](includes/package-manager-failed-to-fetch-rpm.md)]
diff --git a/docs/core/install/linux-package-manager-fedora30.md b/docs/core/install/linux-package-manager-fedora30.md
@@ -56,3 +56,11 @@ sudo dnf install dotnet-runtime-3.1
 ## How to install other versions
 
 [!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]
+
+## Troubleshoot the package manager
+
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-rpm](includes/package-manager-failed-to-fetch-rpm.md)]
diff --git a/docs/core/install/linux-package-manager-fedora31.md b/docs/core/install/linux-package-manager-fedora31.md
@@ -56,3 +56,11 @@ sudo dnf install dotnet-runtime-3.1
 ## How to install other versions
 
 [!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]
+
+## Troubleshoot the package manager
+
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-rpm](includes/package-manager-failed-to-fetch-rpm.md)]
diff --git a/docs/core/install/linux-package-manager-opensuse15.md b/docs/core/install/linux-package-manager-opensuse15.md
@@ -59,3 +59,11 @@ sudo zypper install dotnet-runtime-3.1
 ## How to install other versions
 
 [!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]
+
+## Troubleshoot the package manager
+
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-rpm](includes/package-manager-failed-to-fetch-rpm.md)]
diff --git a/docs/core/install/linux-package-manager-sles12.md b/docs/core/install/linux-package-manager-sles12.md
@@ -55,3 +55,11 @@ sudo zypper install dotnet-runtime-3.1
 ## How to install other versions
 
 [!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]
+
+## Troubleshoot the package manager
+
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-rpm](includes/package-manager-failed-to-fetch-rpm.md)]
diff --git a/docs/core/install/linux-package-manager-sles15.md b/docs/core/install/linux-package-manager-sles15.md
@@ -55,3 +55,11 @@ sudo zypper install dotnet-runtime-3.1
 ## How to install other versions
 
 [!INCLUDE [package-manager-switcher](./includes/package-manager-heading-hack-pkgname.md)]
+
+## Troubleshoot the package manager
+
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-deb](includes/package-manager-failed-to-fetch-rpm.md)]
diff --git a/docs/core/install/linux-package-manager-ubuntu-1604.md b/docs/core/install/linux-package-manager-ubuntu-1604.md
@@ -77,6 +77,10 @@ sudo apt-get install dotnet-runtime-3.1
 
 ## Troubleshoot the package manager
 
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Unable to locate
+
 If you receive an error message similar to **Unable to locate package {the .NET Core package}**, run the following commands.
 
 ```bash
@@ -99,3 +103,7 @@ sudo apt-get install -y apt-transport-https
 sudo apt-get update
 sudo apt-get install {the .NET Core package}
 ```
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-deb](includes/package-manager-failed-to-fetch-deb.md)]
diff --git a/docs/core/install/linux-package-manager-ubuntu-1804.md b/docs/core/install/linux-package-manager-ubuntu-1804.md
@@ -80,6 +80,10 @@ sudo apt-get install dotnet-runtime-3.1
 
 ## Troubleshoot the package manager
 
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Unable to locate
+
 If you receive an error message similar to **Unable to locate package {the .NET Core package}**, run the following commands.
 
 ```bash
@@ -102,3 +106,7 @@ sudo apt-get install -y apt-transport-https
 sudo apt-get update
 sudo apt-get install {the .NET Core package}
 ```
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-deb](includes/package-manager-failed-to-fetch-deb.md)]
diff --git a/docs/core/install/linux-package-manager-ubuntu-1904.md b/docs/core/install/linux-package-manager-ubuntu-1904.md
@@ -77,6 +77,10 @@ sudo apt-get install dotnet-runtime-3.1
 
 ## Troubleshoot the package manager
 
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Unable to locate
+
 If you receive an error message similar to **Unable to locate package {the .NET Core package}**, run the following commands.
 
 ```bash
@@ -99,3 +103,7 @@ sudo apt-get install -y apt-transport-https
 sudo apt-get update
 sudo apt-get install {the .NET Core package}
 ```
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-deb](includes/package-manager-failed-to-fetch-deb.md)]
diff --git a/docs/core/install/linux-package-manager-ubuntu-1910.md b/docs/core/install/linux-package-manager-ubuntu-1910.md
@@ -77,6 +77,10 @@ sudo apt-get install dotnet-runtime-3.1
 
 ## Troubleshoot the package manager
 
+This section provides information on common errors you may get while using the package manager to install .NET Core.
+
+### Unable to locate
+
 If you receive an error message similar to **Unable to locate package {the .NET Core package}**, run the following commands.
 
 ```bash
@@ -99,3 +103,7 @@ sudo apt-get install -y apt-transport-https
 sudo apt-get update
 sudo apt-get install {the .NET Core package}
 ```
+
+### Failed to fetch
+
+[!INCLUDE [package-manager-failed-to-fetch-deb](includes/package-manager-failed-to-fetch-deb.md)]
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@

		While installing the .NET Core package, you may see an error similar to `Failed to fetch ... File has unexpected size ... Mirror sync in progress?`. Generally speaking, this error means that the package feed for .NET Core is being upgraded with newer package versions, and that you should try again later. During an upgrade, the package feed should not be unavailable for more than 30 minutes. If you continually receive this error for more than 30 minutes, please file an issue at <https://github.com/dotnet/core/issues>.
Copy link Contributor tdykstra Jan 29, 2020 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others. Learn more. We usually avoid use of "please". Copy link Contributor Author Thraka Jan 29, 2020 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others. Learn more. @tdykstra I know. Acro complains that it doesn't add anything. But in this case, I think it does. We're really requesting users to file an issue so that we can be alerted to the problem. Thoughts? Copy link Contributor tdykstra Jan 29, 2020 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others. Learn more. It's your call -- if you think it's justified in this instance I'm fine with it. I agree it would sound a bit abrupt here without it. Copy link Member dagood Jan 29, 2020 Choose a reason for hiding this comment The reason will be displayed to describe this comment to others. Learn more. I agree it makes sense for this message. Style guide on please: Avoid please except in situations where the customer is asked to do something inconvenient or the application or site is to blame for the situation. Example The network connection was lost. Please reenter your password. The service is to blame, and it's inconvenient to have to file an issue to let us know. tdykstra reacted with thumbs up emoji