Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Reorg tutorials toc #18515

Merged
merged 6 commits into from
May 22, 2020
Merged

Reorg tutorials toc #18515

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
65a76b7
initial toc reorg
tdykstra May 19, 2020
318dd4d
update tutorials/index.md
tdykstra May 19, 2020
df32ad2
split cli and cli/vsc sections
tdykstra May 19, 2020
7addb18
add link and remove dup link
tdykstra May 19, 2020
cdd40f8
corrections
tdykstra May 19, 2020
d13b11a
more reorg
tdykstra May 20, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
140 changes: 89 additions & 51 deletions docs/core/toc.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tdykstra Was this tutorial excluded from the updated TOC on purpose?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

plugins moved to the Advanced section. ASP.NET Core is included in "More tutorials"

  - name: More tutorials
    href: tutorials/index.md

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was referring to aspnet-core.md, sorry. I don't see it in https://raw.githubusercontent.com/dotnet/docs/master/docs/core/tutorials/index.md.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ASP.NET Core is covered by these lines

## Create web apps

For tutorials about developing ASP.NET Core web applications, see the [ASP.NET Core documentation](/aspnet/core/).

aspnet-core.md should have been deleted.

- 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
Expand Down Expand Up @@ -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
Expand Down
54 changes: 30 additions & 24 deletions docs/core/tutorials/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/).