Move service reference projects into Tools directory (#13185)

- start of #4914 and #4896 - make infrastructure more accessible to these projects - update list of projects - run `.\eng\scripts\GenerateProjectList.ps1`
dotnet · Aug 17, 2019 · 04b1adb · 04b1adb
1 parent 96d612c
commit 04b1adb
Show file tree

Hide file tree

Showing 56 changed files with 81 additions and 98 deletions.
diff --git a/eng/ProjectReferences.props b/eng/ProjectReferences.props
@@ -8,11 +8,11 @@
     <ProjectReferenceProvider Include="Microsoft.AspNetCore.ApiAuthorization.IdentityServer" ProjectPath="$(RepoRoot)src\Identity\ApiAuthorization.IdentityServer\src\Microsoft.AspNetCore.ApiAuthorization.IdentityServer.csproj"  />
     <ProjectReferenceProvider Include="Microsoft.AspNetCore.Identity.Specification.Tests" ProjectPath="$(RepoRoot)src\Identity\Specification.Tests\src\Microsoft.AspNetCore.Identity.Specification.Tests.csproj"  />
     <ProjectReferenceProvider Include="Microsoft.Web.Xdt.Extensions" ProjectPath="$(RepoRoot)src\SiteExtensions\Microsoft.Web.Xdt.Extensions\src\Microsoft.Web.Xdt.Extensions.csproj"  />
+    <ProjectReferenceProvider Include="dotnet-getdocument" ProjectPath="$(RepoRoot)src\Tools\dotnet-getdocument\src\dotnet-getdocument.csproj"  />
+    <ProjectReferenceProvider Include="Microsoft.Extensions.ApiDescription.Client" ProjectPath="$(RepoRoot)src\Tools\Extensions.ApiDescription.Client\src\Microsoft.Extensions.ApiDescription.Client.csproj"  />
+    <ProjectReferenceProvider Include="Microsoft.Extensions.ApiDescription.Server" ProjectPath="$(RepoRoot)src\Tools\Extensions.ApiDescription.Server\src\Microsoft.Extensions.ApiDescription.Server.csproj"  />
     <ProjectReferenceProvider Include="Microsoft.AspNetCore.DeveloperCertificates.XPlat" ProjectPath="$(RepoRoot)src\Tools\FirstRunCertGenerator\src\Microsoft.AspNetCore.DeveloperCertificates.XPlat.csproj"  />
-    <ProjectReferenceProvider Include="dotnet-getdocument" ProjectPath="$(RepoRoot)src\Mvc\dotnet-getdocument\src\dotnet-getdocument.csproj"  />
-    <ProjectReferenceProvider Include="Microsoft.Extensions.ApiDescription.Client" ProjectPath="$(RepoRoot)src\Mvc\Extensions.ApiDescription.Client\src\Microsoft.Extensions.ApiDescription.Client.csproj"  />
-    <ProjectReferenceProvider Include="Microsoft.Extensions.ApiDescription.Server" ProjectPath="$(RepoRoot)src\Mvc\Extensions.ApiDescription.Server\src\Microsoft.Extensions.ApiDescription.Server.csproj"  />
-    <ProjectReferenceProvider Include="GetDocument.Insider" ProjectPath="$(RepoRoot)src\Mvc\GetDocumentInsider\src\GetDocumentInsider.csproj"  />
+    <ProjectReferenceProvider Include="GetDocument.Insider" ProjectPath="$(RepoRoot)src\Tools\GetDocumentInsider\src\GetDocumentInsider.csproj"  />
     <ProjectReferenceProvider Include="Microsoft.AspNetCore.SignalR.Specification.Tests" ProjectPath="$(RepoRoot)src\SignalR\server\Specification.Tests\src\Microsoft.AspNetCore.SignalR.Specification.Tests.csproj"  />
     <ProjectReferenceProvider Include="Microsoft.AspNetCore.Blazor.Build" ProjectPath="$(RepoRoot)src\Components\Blazor\Build\src\Microsoft.AspNetCore.Blazor.Build.csproj"  />
     <ProjectReferenceProvider Include="Microsoft.AspNetCore" ProjectPath="$(RepoRoot)src\DefaultBuilder\src\Microsoft.AspNetCore.csproj" RefProjectPath="$(RepoRoot)src\DefaultBuilder\ref\Microsoft.AspNetCore.csproj" />

diff --git a/src/Mvc/Mvc.sln b/src/Mvc/Mvc.sln
@@ -81,12 +81,6 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Mvc.Api.Analyzers.Test", "M
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.AspNetCore.Mvc.Api.Analyzers", "Mvc.Api.Analyzers\src\Microsoft.AspNetCore.Mvc.Api.Analyzers.csproj", "{3B550487-10E4-4E6D-9CEF-B1B4CA1253DA}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "dotnet-getdocument", "dotnet-getdocument\src\dotnet-getdocument.csproj", "{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "GetDocumentInsider", "GetDocumentInsider\src\GetDocumentInsider.csproj", "{2F683CF8-B055-46AE-BF83-9D1307F8D45F}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Extensions.ApiDescription.Client", "Extensions.ApiDescription.Client\src\Microsoft.Extensions.ApiDescription.Client.csproj", "{34E3C302-B767-40C8-B538-3EE2BD4000C4}"
-EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "_dependencies", "_dependencies", "{5FE3048A-E96B-44F8-A7C4-FC590D7E04B4}"
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.AspNetCore.Html.Abstractions", "..\Html\Abstractions\src\Microsoft.AspNetCore.Html.Abstractions.csproj", "{0930C2EA-FA36-4EDF-A571-215765D1F2C7}"
@@ -275,8 +269,6 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Mvc.Analyzers", "Mvc.Analyz
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Mvc.Api.Analyzers", "Mvc.Api.Analyzers", "{49887FD5-2E52-4567-929E-9151DC88E4D4}"
 EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Extensions.ApiDescription.Client", "Extensions.ApiDescription.Client", "{62CF82C1-B75D-4041-A7E9-EF39FF7B885F}"
-EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.AspNetCore.Mvc.Core.TestCommon", "shared\Mvc.Core.TestCommon\Microsoft.AspNetCore.Mvc.Core.TestCommon.csproj", "{2906BF70-82BE-4427-870A-E87281D01008}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Mvc.NewtonsoftJson", "Mvc.NewtonsoftJson", "{25C08DED-1C7D-4C6D-B1CC-F340C1B21DE7}"
@@ -315,10 +307,6 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "RazorBuildWebSite.Precompil
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.AspNetCore.SignalR.Protocols.Json", "..\SignalR\common\Protocols.Json\src\Microsoft.AspNetCore.SignalR.Protocols.Json.csproj", "{637119E8-5BBB-4FC7-A372-DAF38FF5EBD9}"
 EndProject
-Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Extensions.ApiDescription.Server", "Extensions.ApiDescription.Server", "{C15AA245-9E54-4FD6-90FF-B46F47779C46}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Extensions.ApiDescription.Server", "Extensions.ApiDescription.Server\src\Microsoft.Extensions.ApiDescription.Server.csproj", "{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}"
-EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.AspNetCore.Metadata", "..\Http\Metadata\src\Microsoft.AspNetCore.Metadata.csproj", "{464195B3-022A-4D19-9104-8C66CC882D67}"
 EndProject
 Global
@@ -649,42 +637,6 @@ Global
 		{3B550487-10E4-4E6D-9CEF-B1B4CA1253DA}.Release|Mixed Platforms.Build.0 = Release|Any CPU
 		{3B550487-10E4-4E6D-9CEF-B1B4CA1253DA}.Release|x86.ActiveCfg = Release|Any CPU
 		{3B550487-10E4-4E6D-9CEF-B1B4CA1253DA}.Release|x86.Build.0 = Release|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Debug|x86.Build.0 = Debug|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Release|Any CPU.Build.0 = Release|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Release|Mixed Platforms.Build.0 = Release|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Release|x86.ActiveCfg = Release|Any CPU
-		{4EDC489F-3EC5-4AE3-9841-A285F40F5FF6}.Release|x86.Build.0 = Release|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Debug|x86.Build.0 = Debug|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Release|Any CPU.Build.0 = Release|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Release|Mixed Platforms.Build.0 = Release|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Release|x86.ActiveCfg = Release|Any CPU
-		{2F683CF8-B055-46AE-BF83-9D1307F8D45F}.Release|x86.Build.0 = Release|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Debug|x86.Build.0 = Debug|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Release|Any CPU.Build.0 = Release|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Release|Mixed Platforms.Build.0 = Release|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Release|x86.ActiveCfg = Release|Any CPU
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4}.Release|x86.Build.0 = Release|Any CPU
 		{0930C2EA-FA36-4EDF-A571-215765D1F2C7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{0930C2EA-FA36-4EDF-A571-215765D1F2C7}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{0930C2EA-FA36-4EDF-A571-215765D1F2C7}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
@@ -1789,30 +1741,6 @@ Global
 		{A8C3066F-E80D-4E03-9962-741B551B8FBC}.Release|Mixed Platforms.Build.0 = Release|Any CPU
 		{A8C3066F-E80D-4E03-9962-741B551B8FBC}.Release|x86.ActiveCfg = Release|Any CPU
 		{A8C3066F-E80D-4E03-9962-741B551B8FBC}.Release|x86.Build.0 = Release|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Debug|x86.Build.0 = Debug|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Release|Any CPU.Build.0 = Release|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Release|Mixed Platforms.Build.0 = Release|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Release|x86.ActiveCfg = Release|Any CPU
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890}.Release|x86.Build.0 = Release|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Debug|x86.Build.0 = Debug|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Release|Any CPU.Build.0 = Release|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Release|Mixed Platforms.Build.0 = Release|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Release|x86.ActiveCfg = Release|Any CPU
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926}.Release|x86.Build.0 = Release|Any CPU
 		{637119E8-5BBB-4FC7-A372-DAF38FF5EBD9}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{637119E8-5BBB-4FC7-A372-DAF38FF5EBD9}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{637119E8-5BBB-4FC7-A372-DAF38FF5EBD9}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
@@ -1825,18 +1753,6 @@ Global
 		{637119E8-5BBB-4FC7-A372-DAF38FF5EBD9}.Release|Mixed Platforms.Build.0 = Release|Any CPU
 		{637119E8-5BBB-4FC7-A372-DAF38FF5EBD9}.Release|x86.ActiveCfg = Release|Any CPU
 		{637119E8-5BBB-4FC7-A372-DAF38FF5EBD9}.Release|x86.Build.0 = Release|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Debug|Any CPU.Build.0 = Debug|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Debug|Mixed Platforms.Build.0 = Debug|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Debug|x86.ActiveCfg = Debug|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Debug|x86.Build.0 = Debug|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Release|Any CPU.ActiveCfg = Release|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Release|Any CPU.Build.0 = Release|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Release|Mixed Platforms.ActiveCfg = Release|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Release|Mixed Platforms.Build.0 = Release|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Release|x86.ActiveCfg = Release|Any CPU
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2}.Release|x86.Build.0 = Release|Any CPU
 		{464195B3-022A-4D19-9104-8C66CC882D67}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{464195B3-022A-4D19-9104-8C66CC882D67}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{464195B3-022A-4D19-9104-8C66CC882D67}.Debug|Mixed Platforms.ActiveCfg = Debug|Any CPU
@@ -1883,7 +1799,6 @@ Global
 		{51E3E785-A9D1-4196-BAFE-A17FF4304B89} = {75A3249D-E8DB-42F1-9B4E-1DCC662856A0}
 		{DD7B9F20-354C-4D9E-8C8A-8AE6E7595A87} = {49887FD5-2E52-4567-929E-9151DC88E4D4}
 		{3B550487-10E4-4E6D-9CEF-B1B4CA1253DA} = {49887FD5-2E52-4567-929E-9151DC88E4D4}
-		{34E3C302-B767-40C8-B538-3EE2BD4000C4} = {62CF82C1-B75D-4041-A7E9-EF39FF7B885F}
 		{0930C2EA-FA36-4EDF-A571-215765D1F2C7} = {5FE3048A-E96B-44F8-A7C4-FC590D7E04B4}
 		{A273BAAB-DA92-401D-B781-ADA9E3B7717C} = {5FE3048A-E96B-44F8-A7C4-FC590D7E04B4}
 		{E07B7D3A-1D4D-4644-84C2-06FEDB64885B} = {5FE3048A-E96B-44F8-A7C4-FC590D7E04B4}
@@ -1976,10 +1891,7 @@ Global
 		{F85D8F0C-2300-4021-B5C4-A245D94FF419} = {5FE3048A-E96B-44F8-A7C4-FC590D7E04B4}
 		{F99CAC82-C96E-41F4-AA28-1BBBD09C447A} = {5FE3048A-E96B-44F8-A7C4-FC590D7E04B4}
 		{A8C3066F-E80D-4E03-9962-741B551B8FBC} = {16703B76-C9F7-4C75-AE6C-53D92E308E3C}
-		{6D6489E5-48BD-4F9B-9EEE-22AEEA1E1890} = {45CE788D-4B69-4F83-981C-F43D8F15B0F1}
-		{C6F3BCE6-1EFD-4360-932B-B98573E78926} = {45CE788D-4B69-4F83-981C-F43D8F15B0F1}
 		{637119E8-5BBB-4FC7-A372-DAF38FF5EBD9} = {5FE3048A-E96B-44F8-A7C4-FC590D7E04B4}
-		{D7CF2A1E-A29E-45AB-9C2A-CD6C3BAE54F2} = {C15AA245-9E54-4FD6-90FF-B46F47779C46}
 		{464195B3-022A-4D19-9104-8C66CC882D67} = {5FE3048A-E96B-44F8-A7C4-FC590D7E04B4}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution

diff --git a/src/Mvc/MvcNoDeps.slnf b/src/Mvc/MvcNoDeps.slnf
@@ -2,9 +2,6 @@
   "solution": {
     "path": "Mvc.sln",
     "projects": [
-      "Extensions.ApiDescription.Client\\src\\Microsoft.Extensions.ApiDescription.Client.csproj",
-      "Extensions.ApiDescription.Server\\src\\Microsoft.Extensions.ApiDescription.Server.csproj",
-      "GetDocumentInsider\\src\\GetDocumentInsider.csproj",
       "Mvc.Abstractions\\src\\Microsoft.AspNetCore.Mvc.Abstractions.csproj",
       "Mvc.Abstractions\\test\\Microsoft.AspNetCore.Mvc.Abstractions.Test.csproj",
       "Mvc.Analyzers\\src\\Microsoft.AspNetCore.Mvc.Analyzers.csproj",
@@ -40,7 +37,6 @@
       "Mvc\\src\\Microsoft.AspNetCore.Mvc.csproj",
       "Mvc\\test\\Microsoft.AspNetCore.Mvc.Test.csproj",
       "benchmarks\\Microsoft.AspNetCore.Mvc.Performance\\Microsoft.AspNetCore.Mvc.Performance.csproj",
-      "dotnet-getdocument\\src\\dotnet-getdocument.csproj",
       "samples\\MvcSandbox\\MvcSandbox.csproj",
       "shared\\Mvc.Core.TestCommon\\Microsoft.AspNetCore.Mvc.Core.TestCommon.csproj",
       "shared\\Mvc.TestDiagnosticListener\\Microsoft.AspNetCore.Mvc.TestDiagnosticListener.csproj",

diff --git a/src/Tools/Extensions.ApiDescription.Client/README.md b/src/Tools/Extensions.ApiDescription.Client/README.md
@@ -0,0 +1,7 @@
+# Microsoft.Extensions.ApiDescription.Client
+
+MSBuild glue for OpenAPI code generation.
+
+## How To Use
+
+See partner packages such as [NSwag.ApiDescription.Client](https://www.nuget.org/packages/NSwag.ApiDescription.Client/) for intended use.
diff --git a/...escription.Client/src/CSharpIdentifier.cs → ...escription.Client/src/CSharpIdentifier.cs b/...escription.Client/src/CSharpIdentifier.cs → ...escription.Client/src/CSharpIdentifier.cs
diff --git a/...Description.Client/src/GetCurrentItems.cs → ...Description.Client/src/GetCurrentItems.cs b/...Description.Client/src/GetCurrentItems.cs → ...Description.Client/src/GetCurrentItems.cs
diff --git a/...on.Client/src/GetFileReferenceMetadata.cs → ...on.Client/src/GetFileReferenceMetadata.cs b/...on.Client/src/GetFileReferenceMetadata.cs → ...on.Client/src/GetFileReferenceMetadata.cs
diff --git a/...cription.Client/src/MetadataSerializer.cs → ...cription.Client/src/MetadataSerializer.cs b/...cription.Client/src/MetadataSerializer.cs → ...cription.Client/src/MetadataSerializer.cs
diff --git a/...t.Extensions.ApiDescription.Client.csproj → ...t.Extensions.ApiDescription.Client.csproj b/...t.Extensions.ApiDescription.Client.csproj → ...t.Extensions.ApiDescription.Client.csproj
diff --git a/...t.Extensions.ApiDescription.Client.nuspec → ...t.Extensions.ApiDescription.Client.nuspec b/...t.Extensions.ApiDescription.Client.nuspec → ...t.Extensions.ApiDescription.Client.nuspec
diff --git a/....ApiDescription.Client/src/Resources.resx → ....ApiDescription.Client/src/Resources.resx b/....ApiDescription.Client/src/Resources.resx → ....ApiDescription.Client/src/Resources.resx
diff --git a/...ft.Extensions.ApiDescription.Client.props → ...ft.Extensions.ApiDescription.Client.props b/...ft.Extensions.ApiDescription.Client.props → ...ft.Extensions.ApiDescription.Client.props
diff --git a/....Extensions.ApiDescription.Client.targets → ....Extensions.ApiDescription.Client.targets b/....Extensions.ApiDescription.Client.targets → ....Extensions.ApiDescription.Client.targets
diff --git a/....Client/src/build/OpenApiItemsSchema.xaml → ....Client/src/build/OpenApiItemsSchema.xaml b/....Client/src/build/OpenApiItemsSchema.xaml → ....Client/src/build/OpenApiItemsSchema.xaml
diff --git a/...ft.Extensions.ApiDescription.Client.props → ...ft.Extensions.ApiDescription.Client.props b/...ft.Extensions.ApiDescription.Client.props → ...ft.Extensions.ApiDescription.Client.props
diff --git a/....Extensions.ApiDescription.Client.targets → ....Extensions.ApiDescription.Client.targets b/....Extensions.ApiDescription.Client.targets → ....Extensions.ApiDescription.Client.targets
diff --git a/src/Tools/Extensions.ApiDescription.Server/README.md b/src/Tools/Extensions.ApiDescription.Server/README.md
@@ -0,0 +1,8 @@
+# Microsoft.Extensions.ApiDescription.Client
+
+MSBuild glue for OpenAPI document generation.
+
+## How To Use
+
+See partner packages such as [NSwag.AspNetCore](https://www.nuget.org/packages/NSwag.AspNetCore/) or
+[Swashbuckle.AspNetCore](https://www.nuget.org/packages/Swashbuckle.AspNetCore/) for intended use.
diff --git a/...t.Extensions.ApiDescription.Server.csproj → ...t.Extensions.ApiDescription.Server.csproj b/...t.Extensions.ApiDescription.Server.csproj → ...t.Extensions.ApiDescription.Server.csproj
diff --git a/...t.Extensions.ApiDescription.Server.nuspec → ...t.Extensions.ApiDescription.Server.nuspec b/...t.Extensions.ApiDescription.Server.nuspec → ...t.Extensions.ApiDescription.Server.nuspec
diff --git a/...ft.Extensions.ApiDescription.Server.props → ...ft.Extensions.ApiDescription.Server.props b/...ft.Extensions.ApiDescription.Server.props → ...ft.Extensions.ApiDescription.Server.props
diff --git a/....Extensions.ApiDescription.Server.targets → ....Extensions.ApiDescription.Server.targets b/....Extensions.ApiDescription.Server.targets → ....Extensions.ApiDescription.Server.targets
diff --git a/...ft.Extensions.ApiDescription.Server.props → ...ft.Extensions.ApiDescription.Server.props b/...ft.Extensions.ApiDescription.Server.props → ...ft.Extensions.ApiDescription.Server.props
diff --git a/....Extensions.ApiDescription.Server.targets → ....Extensions.ApiDescription.Server.targets b/....Extensions.ApiDescription.Server.targets → ....Extensions.ApiDescription.Server.targets
diff --git a/src/Tools/GetDocumentInsider/README.md b/src/Tools/GetDocumentInsider/README.md
@@ -0,0 +1,7 @@
+# GetDocument.Insider
+
+`GetDocument.Insider` is a command line tool invoked in `dotnet-getdocument` to generate OpenAPI documents.
+
+## How To Use
+
+Run `dotnet ".../GetDocument.Insider.dll" --help` for more information about usage.
diff --git a/...Mvc/GetDocumentInsider/src/AnsiConsole.cs → ...ols/GetDocumentInsider/src/AnsiConsole.cs b/...Mvc/GetDocumentInsider/src/AnsiConsole.cs → ...ols/GetDocumentInsider/src/AnsiConsole.cs
diff --git a/...c/GetDocumentInsider/src/AnsiConstants.cs → ...s/GetDocumentInsider/src/AnsiConstants.cs b/...c/GetDocumentInsider/src/AnsiConstants.cs → ...s/GetDocumentInsider/src/AnsiConstants.cs
diff --git a/.../GetDocumentInsider/src/AnsiTextWriter.cs → .../GetDocumentInsider/src/AnsiTextWriter.cs b/.../GetDocumentInsider/src/AnsiTextWriter.cs → .../GetDocumentInsider/src/AnsiTextWriter.cs
diff --git a/...etDocumentInsider/src/CommandException.cs → ...etDocumentInsider/src/CommandException.cs b/...etDocumentInsider/src/CommandException.cs → ...etDocumentInsider/src/CommandException.cs
diff --git a/...r/src/CommandLineUtils/CommandArgument.cs → ...r/src/CommandLineUtils/CommandArgument.cs b/...r/src/CommandLineUtils/CommandArgument.cs → ...r/src/CommandLineUtils/CommandArgument.cs
diff --git a/...ommandLineUtils/CommandLineApplication.cs → ...ommandLineUtils/CommandLineApplication.cs b/...ommandLineUtils/CommandLineApplication.cs → ...ommandLineUtils/CommandLineApplication.cs
diff --git a/...Utils/CommandLineApplicationExtensions.cs → ...Utils/CommandLineApplicationExtensions.cs b/...Utils/CommandLineApplicationExtensions.cs → ...Utils/CommandLineApplicationExtensions.cs
diff --git a/...der/src/CommandLineUtils/CommandOption.cs → ...der/src/CommandLineUtils/CommandOption.cs b/...der/src/CommandLineUtils/CommandOption.cs → ...der/src/CommandLineUtils/CommandOption.cs
diff --git a/...src/CommandLineUtils/CommandOptionType.cs → ...src/CommandLineUtils/CommandOptionType.cs b/...src/CommandLineUtils/CommandOptionType.cs → ...src/CommandLineUtils/CommandOptionType.cs
diff --git a/...mmandLineUtils/CommandParsingException.cs → ...mmandLineUtils/CommandParsingException.cs b/...mmandLineUtils/CommandParsingException.cs → ...mmandLineUtils/CommandParsingException.cs
diff --git a/...cumentInsider/src/Commands/CommandBase.cs → ...cumentInsider/src/Commands/CommandBase.cs b/...cumentInsider/src/Commands/CommandBase.cs → ...cumentInsider/src/Commands/CommandBase.cs
diff --git a/...nsider/src/Commands/GetDocumentCommand.cs → ...nsider/src/Commands/GetDocumentCommand.cs b/...nsider/src/Commands/GetDocumentCommand.cs → ...nsider/src/Commands/GetDocumentCommand.cs
diff --git a/...src/Commands/GetDocumentCommandContext.cs → ...src/Commands/GetDocumentCommandContext.cs b/...src/Commands/GetDocumentCommandContext.cs → ...src/Commands/GetDocumentCommandContext.cs
diff --git a/.../src/Commands/GetDocumentCommandWorker.cs → .../src/Commands/GetDocumentCommandWorker.cs b/.../src/Commands/GetDocumentCommandWorker.cs → .../src/Commands/GetDocumentCommandWorker.cs
diff --git a/...ntInsider/src/Commands/HelpCommandBase.cs → ...ntInsider/src/Commands/HelpCommandBase.cs b/...ntInsider/src/Commands/HelpCommandBase.cs → ...ntInsider/src/Commands/HelpCommandBase.cs
diff --git a/...nsider/src/Commands/ProjectCommandBase.cs → ...nsider/src/Commands/ProjectCommandBase.cs b/...nsider/src/Commands/ProjectCommandBase.cs → ...nsider/src/Commands/ProjectCommandBase.cs
diff --git a/...mentInsider/src/GetDocumentInsider.csproj → ...mentInsider/src/GetDocumentInsider.csproj b/...mentInsider/src/GetDocumentInsider.csproj → ...mentInsider/src/GetDocumentInsider.csproj
diff --git a/...Mvc/GetDocumentInsider/src/ProductInfo.cs → ...ols/GetDocumentInsider/src/ProductInfo.cs b/...Mvc/GetDocumentInsider/src/ProductInfo.cs → ...ols/GetDocumentInsider/src/ProductInfo.cs
diff --git a/src/Mvc/GetDocumentInsider/src/Program.cs → src/Tools/GetDocumentInsider/src/Program.cs b/src/Mvc/GetDocumentInsider/src/Program.cs → src/Tools/GetDocumentInsider/src/Program.cs
diff --git a/src/Mvc/GetDocumentInsider/src/Reporter.cs → src/Tools/GetDocumentInsider/src/Reporter.cs b/src/Mvc/GetDocumentInsider/src/Reporter.cs → src/Tools/GetDocumentInsider/src/Reporter.cs
diff --git a/...Mvc/GetDocumentInsider/src/Resources.resx → ...ols/GetDocumentInsider/src/Resources.resx b/...Mvc/GetDocumentInsider/src/Resources.resx → ...ols/GetDocumentInsider/src/Resources.resx
diff --git a/...ntInsider/src/runtimeconfig.template.json → ...ntInsider/src/runtimeconfig.template.json b/...ntInsider/src/runtimeconfig.template.json → ...ntInsider/src/runtimeconfig.template.json
diff --git a/src/Tools/README.md b/src/Tools/README.md
@@ -1,5 +1,4 @@
-DotNetTools
-===========
+# DotNetTools
 
 ## Projects
 
@@ -14,6 +13,13 @@ The folder contains command-line tools for ASP.NET Core that are bundled* in the
 
 *For 2.0 CLI and earlier, see <https://github.com/aspnet/DotNetTools/tree/rel/2.0.0/README.md> for details.*
 
+This folder also contains the infrastructure for our partners' service reference features:
+
+- [Extensions.ApiDescription.Client](Extensions.ApiDescription.Client/README.md) MSBuild glue for OpenAPI code generation.
+- [Extensions.ApiDescription.Server](Extensions.ApiDescription.Server/README.md) MSBuild glue for OpenAPI document generation.
+- [dotnet-getdocument](dotnet-getdocument/README.md) the outside man of OpenAPI document generation tool.
+- [GetDocument.Insider](GetDocumentInsider/README.md) the inside man of OpenAPI document generation tool.
+
 ## Usage
 
 The command line tools can be invoked as a subcommand of `dotnet`.