diff --git a/src/dotnet/BuiltInCommandsCatalog.cs b/src/dotnet/BuiltInCommandsCatalog.cs
index e649f6cc7..8a6f81824 100644
--- a/src/dotnet/BuiltInCommandsCatalog.cs
+++ b/src/dotnet/BuiltInCommandsCatalog.cs
@@ -148,11 +148,13 @@ namespace Microsoft.DotNet.Cli
},
["tool"] = new BuiltInCommandMetadata
{
- Command = ToolCommand.Run
+ Command = ToolCommand.Run,
+ DocLink = "https://aka.ms/dotnet-tool"
},
["buildserver"] = new BuiltInCommandMetadata
{
- Command = BuildServerCommand.Run
+ Command = BuildServerCommand.Run,
+ DocLink = "https://aka.ms/dotnet-build-server"
},
["internal-reportinstallsuccess"] = new BuiltInCommandMetadata
{
diff --git a/src/dotnet/commands/dotnet-help/LocalizableStrings.resx b/src/dotnet/commands/dotnet-help/LocalizableStrings.resx
index 87a781848..07118075e 100644
--- a/src/dotnet/commands/dotnet-help/LocalizableStrings.resx
+++ b/src/dotnet/commands/dotnet-help/LocalizableStrings.resx
@@ -268,9 +268,9 @@
Path to additional deps.json file.
- Modify tools.
+ Install or work with tools that extend the .NET experience.Interact with servers started by a build.
-
\ No newline at end of file
+
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.cs.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.cs.xlf
index b1e85a286..2c79948b5 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.cs.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.cs.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- Upravte nástroje.
+ Install or work with tools that extend the .NET experience.
+ Upravte nástroje.
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.de.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.de.xlf
index f0d6c44b0..1aa8c6c90 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.de.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.de.xlf
@@ -254,8 +254,8 @@
- Modify tools.
- Hiermit werden Tools geändert.
+ Install or work with tools that extend the .NET experience.
+ Hiermit werden Tools geändert.
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.es.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.es.xlf
index 1366d754c..f77be21f4 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.es.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.es.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- Modifica herramientas.
+ Install or work with tools that extend the .NET experience.
+ Modifica herramientas.
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.fr.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.fr.xlf
index ad90d32fa..8cf661d80 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.fr.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.fr.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- Modifier les outils.
+ Install or work with tools that extend the .NET experience.
+ Modifier les outils.
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.it.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.it.xlf
index bab036495..85afcf32e 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.it.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.it.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- Modifica gli strumenti.
+ Install or work with tools that extend the .NET experience.
+ Modifica gli strumenti.
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ja.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ja.xlf
index c796e75eb..8821d75e4 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ja.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ja.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- ツールを変更します。
+ Install or work with tools that extend the .NET experience.
+ ツールを変更します。
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ko.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ko.xlf
index 557594584..aa0fefac0 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ko.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ko.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- 도구를 수정합니다.
+ Install or work with tools that extend the .NET experience.
+ 도구를 수정합니다.
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.pl.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.pl.xlf
index e186025f6..879a0e96e 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.pl.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.pl.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- Zmodyfikuj narzędzia.
+ Install or work with tools that extend the .NET experience.
+ Zmodyfikuj narzędzia.
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.pt-BR.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.pt-BR.xlf
index 6831f4f47..03eaf235e 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.pt-BR.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.pt-BR.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- Modificar ferramentas.
+ Install or work with tools that extend the .NET experience.
+ Modificar ferramentas.
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ru.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ru.xlf
index 0ff8eba10..29891423b 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ru.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.ru.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- Средства для изменения.
+ Install or work with tools that extend the .NET experience.
+ Средства для изменения.
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.tr.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.tr.xlf
index 376a82510..2968a17f9 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.tr.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.tr.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- Araçları değiştirir.
+ Install or work with tools that extend the .NET experience.
+ Araçları değiştirir.
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.zh-Hans.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.zh-Hans.xlf
index 862df02fd..c60a7ee7d 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.zh-Hans.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.zh-Hans.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- 修改工具。
+ Install or work with tools that extend the .NET experience.
+ 修改工具。
diff --git a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.zh-Hant.xlf b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.zh-Hant.xlf
index 2a2ddad7f..bba3fe694 100644
--- a/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.zh-Hant.xlf
+++ b/src/dotnet/commands/dotnet-help/xlf/LocalizableStrings.zh-Hant.xlf
@@ -253,8 +253,8 @@
- Modify tools.
- 修改工具。
+ Install or work with tools that extend the .NET experience.
+ 修改工具。
diff --git a/src/dotnet/commands/dotnet-tool/LocalizableStrings.resx b/src/dotnet/commands/dotnet-tool/LocalizableStrings.resx
index 13ec6c39b..0a277bcb3 100644
--- a/src/dotnet/commands/dotnet-tool/LocalizableStrings.resx
+++ b/src/dotnet/commands/dotnet-tool/LocalizableStrings.resx
@@ -121,6 +121,6 @@
.NET Install Command
- Modify tools.
+ Install or work with tools that extend the .NET experience.
-
\ No newline at end of file
+
diff --git a/src/dotnet/commands/dotnet-tool/install/LocalizableStrings.resx b/src/dotnet/commands/dotnet-tool/install/LocalizableStrings.resx
index 9705509b6..2f818bfe8 100644
--- a/src/dotnet/commands/dotnet-tool/install/LocalizableStrings.resx
+++ b/src/dotnet/commands/dotnet-tool/install/LocalizableStrings.resx
@@ -163,10 +163,13 @@ Tool '{1}' (version '{2}') was successfully installed.
Tool '{0}' failed to install.
-
- Tool '{0}' failed to install. You may need to specify the version using
+
+ Tool '{0}' failed to install. This failure may have been caused by:
- dotnet tool install -g {0} --version <version>
+* You are attempting to install a preview release and did not use the --version option to specify the version.
+* A package by this name was found, but it was not a .NET Core tool.
+* The required NuGet feed cannot be accessed, perhaps because of an Internet connection problem.
+* You mistyped the name of the tool.Tool '{0}' failed to install. Please contact the tool author for assistance.
diff --git a/src/dotnet/commands/dotnet-tool/install/ToolInstallCommandLowLevelErrorConverter.cs b/src/dotnet/commands/dotnet-tool/install/ToolInstallCommandLowLevelErrorConverter.cs
index b73409a32..8323696dc 100644
--- a/src/dotnet/commands/dotnet-tool/install/ToolInstallCommandLowLevelErrorConverter.cs
+++ b/src/dotnet/commands/dotnet-tool/install/ToolInstallCommandLowLevelErrorConverter.cs
@@ -18,7 +18,7 @@ namespace Microsoft.DotNet.Tools.Tool.Install
userFacingMessages = new[]
{
ex.Message,
- string.Format(LocalizableStrings.ToolInstallationFailedWithExplicitVersionGuide, packageId),
+ string.Format(LocalizableStrings.ToolInstallationFailedWithRestoreGuidance, packageId),
};
}
else if (ex is ToolConfigurationException)
diff --git a/src/dotnet/commands/dotnet-tool/install/xlf/LocalizableStrings.cs.xlf b/src/dotnet/commands/dotnet-tool/install/xlf/LocalizableStrings.cs.xlf
index 87ff9977c..e89bdafbd 100644
--- a/src/dotnet/commands/dotnet-tool/install/xlf/LocalizableStrings.cs.xlf
+++ b/src/dotnet/commands/dotnet-tool/install/xlf/LocalizableStrings.cs.xlf
@@ -119,13 +119,19 @@ Nástroj {1} (verze {2}) byl úspěšně nainstalován.
Tool '{0}' failed to install.
-
- Tool '{0}' failed to install. You may need to specify the version using
+
+ Tool '{0}' failed to install. This failure may have been caused by:
- dotnet tool install -g {0} --version <version>
- Tool '{0}' failed to install. You may need to specify the version using
+* You are attempting to install a preview release and did not use the --version option to specify the version.
+* A package by this name was found, but it was not a .NET Core tool.
+* The required NuGet feed cannot be accessed, perhaps because of an Internet connection problem.
+* You mistyped the name of the tool.
+ Tool '{0}' failed to install. This failure may have been caused by:
- dotnet tool install -g {0} --version <version>
+* You are attempting to install a preview release and did not use the --version option to specify the version.
+* A package by this name was found, but it was not a .NET Core tool.
+* The required NuGet feed cannot be accessed, perhaps because of an Internet connection problem.
+* You mistyped the name of the tool.