Reorg tutorials toc (#18515)

* initial toc reorg * update tutorials/index.md * split cli and cli/vsc sections * add link and remove dup link * corrections * more reorg
dotnet · May 22, 2020 · f88b136 · f88b136
1 parent efe2c50
commit f88b136
Show file tree

Hide file tree

Showing 2 changed files with 119 additions and 75 deletions.
diff --git a/docs/core/toc.yml b/docs/core/toc.yml
@@ -81,59 +81,95 @@
   href: compatibility/
 - name: Tutorials
   items:
-  - name: Overview
-    href: tutorials/index.md
-  - name: Get started with .NET Core using Visual Studio
-    href: tutorials/with-visual-studio.md
-  - name: Get started with .NET Core using Visual Studio Code
-    href: tutorials/with-visual-studio-code.md
-  - name: Get started with .NET Core using the CLI
-    href: tutorials/cli-create-console-app.md
-  - name: Get started with .NET Core using Visual Studio Code on macOS
-    href: tutorials/using-on-macos.md
-  - name: Get started with .NET Core using Visual Studio for Mac
-    href: tutorials/using-on-mac-vs.md
-  - name: Debug an application using Visual Studio
-    href: tutorials/debugging-with-visual-studio.md
-  - name: Publish an application with Visual Studio
-    href: tutorials/publishing-with-visual-studio.md
-  - name: Create a .NET Standard library in Visual Studio
-    href: tutorials/library-with-visual-studio.md
-  - name: Test a .NET Standard library in Visual Studio
-    href: tutorials/testing-library-with-visual-studio.md
-  - name: Consume a .NET Standard library in Visual Studio
-    href: tutorials/consuming-library-with-visual-studio.md
-  - name: Build a complete .NET Core solution on macOS
-    href: tutorials/using-on-mac-vs-full-solution.md
-  - name: Organize and test projects with the .NET Core CLI
-    href: tutorials/testing-with-cli.md
-  - name: Develop libraries with cross-platform tools
-    href: tutorials/libraries.md
-  - name: Create a .NET Core app with plugins
-    href: tutorials/creating-app-with-plugin-support.md
-  - name: Develop ASP.NET Core apps
-    href: tutorials/aspnet-core.md
-  - name: Host .NET Core from native code
-    href: tutorials/netcore-hosting.md
-  - name: Create templates for the CLI
+  - name: Use Visual Studio
+    items:
+    - name: Create a console app
+      href: tutorials/with-visual-studio.md
+      displayName: tutorials, visual studio, vs
+    - name: Debug an app
+      href: tutorials/debugging-with-visual-studio.md
+      displayName: tutorials, visual studio, vs
+    - name: Publish an app
+      href: tutorials/publishing-with-visual-studio.md
+      displayName: tutorials, visual studio, vs
+    - name: Create a library
+      href: tutorials/library-with-visual-studio.md
+      displayName: tutorials, visual studio, vs
+    - name: Unit test a library
+      href: tutorials/testing-library-with-visual-studio.md
+      displayName: tutorials, visual studio, vs
+    - name: Use a library
+      href: tutorials/consuming-library-with-visual-studio.md
+      displayName: tutorials, visual studio, vs
+    - name: Live unit test
+      href: /visualstudio/test/live-unit-testing-start
+    - name: Install and use a package
+      href: /nuget/quickstart/install-and-use-a-package-in-visual-studio
+      displayName: tutorials, visual studio, vs
+    - name: Create and publish a package
+      href: /nuget/quickstart/create-and-publish-a-package-using-visual-studio
+      displayName: tutorials, visual studio, vs
+  - name: Use Visual Studio Code
+    items:
+    - name: Create a console app
+      href: tutorials/with-visual-studio-code.md
+      displayName: tutorials, visual studio code, vs code, cli
+    - name: Create a console app and publish it
+      href: tutorials/cli-create-console-app.md
+      displayName: tutorials, cli
+    - name: Create a library and unit test it - macOS
+      href: tutorials/using-on-macos.md
+      displayName: tutorials, visual studio code, vs code, cli
+    - name: Install and use a package
+      href: /nuget/quickstart/install-and-use-a-package-using-the-dotnet-cli
+      displayName: tutorials, cli
+    - name: Create and publish a package
+      href: /nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli
+      displayName: tutorials
+  - name: Use Visual Studio for Mac
     items:
-    - name: 1 - Create an item template
-      href: tutorials/cli-templates-create-item-template.md
-    - name: 2 - Create a project template
-      href: tutorials/cli-templates-create-project-template.md
-    - name: 3 - Create a template pack
-      href: tutorials/cli-templates-create-template-pack.md
-  - name: Create tools for the CLI
+    - name: Create a console app
+      href: tutorials/using-on-mac-vs.md
+      displayName: tutorials
+    - name: Create a library and unit test it
+      href: tutorials/using-on-mac-vs-full-solution.md
+      displayName: tutorials
+    - name: Install and use a package
+      href: /nuget/quickstart/install-and-use-a-package-in-visual-studio-mac
+      displayName: tutorials
+  - name: Advanced topics
     items:
-    - name: 1 - Create a tool
-      displayName: tools, tutorials
-      href: tools/global-tools-how-to-create.md
-    - name: 2 - Use a global tool
-      displayName: tools, tutorials
-      href: tools/global-tools-how-to-use.md
-    - name: 3 - Use a local tool
-      href: tools/local-tools-how-to-use.md
-      displayName: tools, tutorials
+    - name: Unit test an app with xUnit
+      href: tutorials/testing-with-cli.md
+      displayName: tutorials, cli
+    - name: How to create libraries
+      href: tutorials/libraries.md
+    - name: Create templates for the CLI
+      items:
+      - name: 1 - Create an item template
+        href: tutorials/cli-templates-create-item-template.md
+        displayName: tutorials, cli
+      - name: 2 - Create a project template
+        href: tutorials/cli-templates-create-project-template.md
+        displayName: tutorials, cli
+      - name: 3 - Create a template pack
+        href: tutorials/cli-templates-create-template-pack.md
+        displayName: tutorials, cli
+    - name: Create tools for the CLI
+      items:
+      - name: 1 - Create a tool
+        displayName: tools, tutorials, cli
+        href: tools/global-tools-how-to-create.md
+      - name: 2 - Use a global tool
+        displayName: tools, tutorials, cli
+        href: tools/global-tools-how-to-use.md
+      - name: 3 - Use a local tool
+        href: tools/local-tools-how-to-use.md
+        displayName: tools, tutorials, cli
+    - name: Create an app with plugins
+      href: tutorials/creating-app-with-plugin-support.md
+  - name: More tutorials
+    href: tutorials/index.md
 - name: Project SDKs
   items:
   - name: Overview
@@ -441,6 +477,8 @@
   href: distribution-packaging.md
 - name: Expose .NET Core components to COM
   href: native-interop/expose-components-to-com.md
+- name: Host .NET Core from native code
+  href: tutorials/netcore-hosting.md
 - name: Packages, metapackages, and frameworks
   href: packages.md
 - name: Continuous integration

diff --git a/docs/core/tutorials/index.md b/docs/core/tutorials/index.md
@@ -9,39 +9,45 @@ titleSuffix: ""
 
 The following tutorials are available for learning about .NET Core.
 
-## Create applications with Visual Studio
+## Use Visual Studio
 
-- [Create a Hello World console application](with-visual-studio.md)
-- [Debug your Hello World application](debugging-with-visual-studio.md)
-- [Publish your Hello World application](publishing-with-visual-studio.md)
-- [Build a class library](library-with-visual-studio.md)
-- [Test a class library](testing-library-with-visual-studio.md)
-- [Consume a class library](consuming-library-with-visual-studio.md)
-- [Azure Cosmos DB: Get started with the SQL API and .NET Core](/azure/cosmos-db/sql-api-dotnetcore-get-started)
+- [Create a console app](with-visual-studio.md)
+- [Create an F# console app](../../fsharp/get-started/get-started-visual-studio.md)
+- [Debug an app](debugging-with-visual-studio.md)
+- [Publish an app](publishing-with-visual-studio.md)
+- [Create a class library](library-with-visual-studio.md)
+- [Unit test a class library](testing-library-with-visual-studio.md)
+- [Use a class library](consuming-library-with-visual-studio.md)
+- [Install and use a package](/nuget/quickstart/install-and-use-a-package-in-visual-studio)
+- [Create and publish a package](/nuget/quickstart/create-and-publish-a-package-using-visual-studio)
 
-## Build applications with Visual Studio Code
+## Use Visual Studio Code
 
-- [Get started with C# and Visual Studio Code](with-visual-studio-code.md)
-- [Get started with .NET Core on macOS](using-on-macos.md)
+Choose these tutorials if you want to use Visual Studio Code or some other code editor. All use the CLI for .NET Core development tasks, so all can be used with any code editor.
 
-## Build applications with Visual Studio for Mac
+- [Create a console app](with-visual-studio-code.md)
+- [Create a console app and publish it](cli-create-console-app.md)
+- [Create an F# console app](../../fsharp/get-started/get-started-vscode.md)
+- [Create a library and unit test it - macOS](using-on-macos.md)
+- [Install and use a package](/nuget/quickstart/install-and-use-a-package-using-the-dotnet-cli)
+- [Create and publish a package](/nuget/quickstart/create-and-publish-a-package-using-the-dotnet-cli)
 
-- [Get started with .NET Core on macOS using Visual Studio for Mac](using-on-mac-vs.md)
-- [Building a complete .NET Core solution on macOS using Visual Studio for Mac](using-on-mac-vs-full-solution.md)
+## Use Visual Studio for Mac
 
-## Build applications with the .NET Core CLI
+- [Create a console app](using-on-mac-vs.md)
+- [Create a library and unit test it](using-on-mac-vs-full-solution.md)
+- [Install and use a package](/nuget/quickstart/install-and-use-a-package-in-visual-studio-mac)
 
-- [Get started with .NET Core on Windows/Linux/macOS using the .NET Core CLI](cli-create-console-app.md)
-- [Organizing and testing projects with the .NET Core CLI](testing-with-cli.md)
-- [Get started with F#](../../fsharp/get-started/get-started-command-line.md)
+## Advanced topics
 
-## Other
-
-- [Unit Testing in .NET Core using dotnet test](../testing/unit-testing-with-dotnet-test.md)
-- [Unit testing with MSTest and .NET Core](../testing/unit-testing-with-mstest.md)
-- [Developing Libraries with Cross Platform Tools](libraries.md)
-- [Hosting .NET Core from native code](netcore-hosting.md)
+- [How to create libraries](libraries.md)
+- [Unit test an app with xUnit](testing-with-cli.md)
+- [Unit test using C#/VB/F# with NUnit/xUnit/MSTest](../testing/index.md)
+- [Live unit test with Visual Studio](/visualstudio/test/live-unit-testing-start)
 - [Create templates for the CLI](cli-templates-create-item-template.md)
 - [Create and use tools for the CLI](../tools/global-tools-how-to-create.md)
+- [Create an app with plugins](creating-app-with-plugin-support.md)
+
+## Create web apps
 
 For tutorials about developing ASP.NET Core web applications, see the [ASP.NET Core documentation](/aspnet/core/).