From 65a76b7539deb0d5e42b33d62b8c6ba39ffaa49d Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Tue, 19 May 2020 11:38:30 -0700 Subject: [PATCH 1/6] initial toc reorg --- docs/core/toc.yml | 136 +++++++++++++++++++++++++++++----------------- 1 file changed, 85 insertions(+), 51 deletions(-) diff --git a/docs/core/toc.yml b/docs/core/toc.yml index 448e01f6e3490..d5f066f78a28a 100644 --- a/docs/core/toc.yml +++ b/docs/core/toc.yml @@ -81,59 +81,91 @@ 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: 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/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: 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 the CLI and Visual Studio Code 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: Create a console app + href: tutorials/with-visual-studio-code.md + displayName: tutorials, visual studio code, vs code, cli + - name: Create a library and unit test it on macOS + href: tutorials/using-on-macos.md + displayName: tutorials, visual studio code, vs code, cli + - name: 1 - Create a console app and publish it + href: tutorials/cli-create-console-app.md + displayName: tutorials, cli + - name: 2 - Unit test an app + href: tutorials/testing-with-cli.md + displayName: tutorials, cli + - name: How to create libraries + href: tutorials/libraries.md + - 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: 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: Use Visual Studio for Mac + items: + - 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: Develop ASP.NET Core web apps + href: tutorials/aspnet-core.md + displayName: tutorials + - name: More tutorials + href: tutorials/index.md - name: Project SDKs items: - name: Overview @@ -441,6 +473,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 From 318dd4d68d7e6a2897c6dfc0520543f97d5751e1 Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Tue, 19 May 2020 12:11:21 -0700 Subject: [PATCH 2/6] update tutorials/index.md --- docs/core/tutorials/index.md | 55 +++++++++++++++++++----------------- 1 file changed, 29 insertions(+), 26 deletions(-) diff --git a/docs/core/tutorials/index.md b/docs/core/tutorials/index.md index df0896b405b43..700867c12a932 100644 --- a/docs/core/tutorials/index.md +++ b/docs/core/tutorials/index.md @@ -9,39 +9,42 @@ titleSuffix: "" The following tutorials are available for learning about .NET Core. -## Create applications with 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) +## Use Visual Studio + +- [Create a console app](with-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) +- [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) - [Azure Cosmos DB: Get started with the SQL API and .NET Core](/azure/cosmos-db/sql-api-dotnetcore-get-started) -## Build applications with Visual Studio Code +## Use the CLI and 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) +- [Create a console app](with-visual-studio-code.md) +- [Create a library and unit test it on macOS](using-on-macos.md) -## Build applications with Visual Studio for Mac +## Use the 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) - -## Build applications with the .NET Core CLI - -- [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) +- [1 - Create a console app and publish it](cli-create-console-app.md) +- [2 - Unit test an app](testing-with-cli.md) +- [How to create libraries](libraries.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) +- [Unit test using C#/VB/F# with NUnit/xUnit/MSTest](../testing/index.md) - [Get started with F#](../../fsharp/get-started/get-started-command-line.md) - -## 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) - [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) +## Use Visual Studio for Mac + +- [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) + +## Create web apps + For tutorials about developing ASP.NET Core web applications, see the [ASP.NET Core documentation](/aspnet/core/). From df32ad2ae9df62d8296fa9c1769af5b11bdeba83 Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Tue, 19 May 2020 12:14:28 -0700 Subject: [PATCH 3/6] split cli and cli/vsc sections --- docs/core/toc.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/core/toc.yml b/docs/core/toc.yml index d5f066f78a28a..966642b695cd2 100644 --- a/docs/core/toc.yml +++ b/docs/core/toc.yml @@ -112,6 +112,8 @@ - name: Create a library and unit test it on macOS href: tutorials/using-on-macos.md displayName: tutorials, visual studio code, vs code, cli + - name: Use the CLI + items: - name: 1 - Create a console app and publish it href: tutorials/cli-create-console-app.md displayName: tutorials, cli From 7addb1826e99615bc819a0b63a97250a72d54ebc Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Tue, 19 May 2020 12:31:41 -0700 Subject: [PATCH 4/6] add link and remove dup link --- docs/core/toc.yml | 2 ++ docs/core/tutorials/index.md | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/core/toc.yml b/docs/core/toc.yml index 966642b695cd2..24ce3c183d410 100644 --- a/docs/core/toc.yml +++ b/docs/core/toc.yml @@ -98,6 +98,8 @@ - name: Unit test a library href: tutorials/testing-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 diff --git a/docs/core/tutorials/index.md b/docs/core/tutorials/index.md index 700867c12a932..53df242bdd245 100644 --- a/docs/core/tutorials/index.md +++ b/docs/core/tutorials/index.md @@ -17,7 +17,7 @@ The following tutorials are available for learning about .NET Core. - [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) -- [Use a class library](consuming-library-with-visual-studio.md) +- [Live unit test](/visualstudio/test/live-unit-testing-start) - [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) - [Azure Cosmos DB: Get started with the SQL API and .NET Core](/azure/cosmos-db/sql-api-dotnetcore-get-started) From cdd40f8f1c80c7283af1ea414ad39cc820ac7854 Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Tue, 19 May 2020 13:22:57 -0700 Subject: [PATCH 5/6] corrections --- docs/core/toc.yml | 9 ++++++--- docs/core/tutorials/index.md | 11 ++++++----- 2 files changed, 12 insertions(+), 8 deletions(-) diff --git a/docs/core/toc.yml b/docs/core/toc.yml index 24ce3c183d410..adedad2a54da3 100644 --- a/docs/core/toc.yml +++ b/docs/core/toc.yml @@ -98,6 +98,9 @@ - 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 @@ -111,15 +114,15 @@ - name: Create a console app href: tutorials/with-visual-studio-code.md displayName: tutorials, visual studio code, vs code, cli - - name: Create a library and unit test it on macOS + - name: Create a library and unit test it - macOS href: tutorials/using-on-macos.md displayName: tutorials, visual studio code, vs code, cli - name: Use the CLI items: - - name: 1 - Create a console app and publish it + - name: Create a console app and publish it href: tutorials/cli-create-console-app.md displayName: tutorials, cli - - name: 2 - Unit test an app + - name: Unit test an app with xUnit href: tutorials/testing-with-cli.md displayName: tutorials, cli - name: How to create libraries diff --git a/docs/core/tutorials/index.md b/docs/core/tutorials/index.md index 53df242bdd245..2c8edf253d266 100644 --- a/docs/core/tutorials/index.md +++ b/docs/core/tutorials/index.md @@ -20,24 +20,25 @@ The following tutorials are available for learning about .NET Core. - [Live unit test](/visualstudio/test/live-unit-testing-start) - [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) -- [Azure Cosmos DB: Get started with the SQL API and .NET Core](/azure/cosmos-db/sql-api-dotnetcore-get-started) +- [Get started with F#](../../fsharp/get-started/get-started-visual-studio.md) ## Use the CLI and Visual Studio Code - [Create a console app](with-visual-studio-code.md) -- [Create a library and unit test it on macOS](using-on-macos.md) +- [Create a library and unit test it - macOS](using-on-macos.md) +- [Get started with F#](../../fsharp/get-started/get-started-vscode.md) ## Use the CLI -- [1 - Create a console app and publish it](cli-create-console-app.md) -- [2 - Unit test an app](testing-with-cli.md) +- [Create a console app and publish it](cli-create-console-app.md) +- [Unit test an app with xUnit](testing-with-cli.md) - [How to create libraries](libraries.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) - [Unit test using C#/VB/F# with NUnit/xUnit/MSTest](../testing/index.md) -- [Get started with F#](../../fsharp/get-started/get-started-command-line.md) - [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) +- [Get started with F#](../../fsharp/get-started/get-started-command-line.md) ## Use Visual Studio for Mac From d13b11a63d3c2ad8b02d94ba11acded7d4d565f9 Mon Sep 17 00:00:00 2001 From: Tom Dykstra Date: Wed, 20 May 2020 09:04:46 -0700 Subject: [PATCH 6/6] more reorg --- docs/core/toc.yml | 47 +++++++++++++++++------------------- docs/core/tutorials/index.md | 30 ++++++++++++----------- 2 files changed, 38 insertions(+), 39 deletions(-) diff --git a/docs/core/toc.yml b/docs/core/toc.yml index adedad2a54da3..f6d10fd427135 100644 --- a/docs/core/toc.yml +++ b/docs/core/toc.yml @@ -109,30 +109,41 @@ - name: Create and publish a package href: /nuget/quickstart/create-and-publish-a-package-using-visual-studio displayName: tutorials, visual studio, vs - - name: Use the CLI and Visual Studio Code + - 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 library and unit test it - macOS - href: tutorials/using-on-macos.md - displayName: tutorials, visual studio code, vs code, cli - - name: Use the CLI - items: - name: Create a console app and publish it href: tutorials/cli-create-console-app.md displayName: tutorials, cli - - 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 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: 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: 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 @@ -157,20 +168,6 @@ displayName: tools, tutorials, cli - name: Create an app with plugins href: tutorials/creating-app-with-plugin-support.md - - name: Use Visual Studio for Mac - items: - - 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: Develop ASP.NET Core web apps - href: tutorials/aspnet-core.md - displayName: tutorials - name: More tutorials href: tutorials/index.md - name: Project SDKs diff --git a/docs/core/tutorials/index.md b/docs/core/tutorials/index.md index 2c8edf253d266..4e50832446be0 100644 --- a/docs/core/tutorials/index.md +++ b/docs/core/tutorials/index.md @@ -12,33 +12,25 @@ The following tutorials are available for learning about .NET Core. ## Use Visual Studio - [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) -- [Live unit test](/visualstudio/test/live-unit-testing-start) - [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) -- [Get started with F#](../../fsharp/get-started/get-started-visual-studio.md) -## Use the CLI and Visual Studio Code +## Use Visual Studio Code -- [Create a console app](with-visual-studio-code.md) -- [Create a library and unit test it - macOS](using-on-macos.md) -- [Get started with F#](../../fsharp/get-started/get-started-vscode.md) - -## Use the CLI +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. +- [Create a console app](with-visual-studio-code.md) - [Create a console app and publish it](cli-create-console-app.md) -- [Unit test an app with xUnit](testing-with-cli.md) -- [How to create libraries](libraries.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) -- [Unit test using C#/VB/F# with NUnit/xUnit/MSTest](../testing/index.md) -- [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) -- [Get started with F#](../../fsharp/get-started/get-started-command-line.md) ## Use Visual Studio for Mac @@ -46,6 +38,16 @@ The following tutorials are available for learning about .NET Core. - [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) +## Advanced topics + +- [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/).