Skip to content

Restructure console app tutorial series to use IDE zone pivot#51719

Draft
meaghanlewis wants to merge 9 commits intodotnet:mainfrom
meaghanlewis:add-visual-studio-zone-pivot
Draft

Restructure console app tutorial series to use IDE zone pivot#51719
meaghanlewis wants to merge 9 commits intodotnet:mainfrom
meaghanlewis:add-visual-studio-zone-pivot

Conversation

@meaghanlewis
Copy link
Contributor

@meaghanlewis meaghanlewis commented Feb 12, 2026

Summary

This pull request updates and consolidates .NET console application tutorial documentation. It introduces a new, unified tutorial for creating .NET console apps using Visual Studio, Visual Studio Code, or GitHub Codespaces, and updates references throughout the documentation to point to this new tutorial. Additionally, it adds redirection rules to ensure old tutorial links redirect to the appropriate new locations.

Key changes:

1. Tutorial consolidation and enhancement

  • Renamed and consolidated tutorials to include pivots for Visual Studio, Visual Studio Code, and Codespaces, with step-by-step instructions. Renamed the following tutorials:
    • with-visual-studio-code.md to create-console-app.md
    • debugging-with-visual-studio-code.md to debug-console-app.md
    • publishing-with-visual-studio-code.md to publish-console-app.md
    • library-with-visual-studio-code.md to create-class-library.md
    • testing-library-with-visual-studio-code.md to test-class-library.md

2. Documentation reference updates

  • Updated all references in installation, deployment, and diagnostics docs to point to the new tutorials instead of the old Visual Studio/VS Code specific tutorials.

3. Redirection rules

  • Added new entries to .openpublishing.redirection.json to redirect old tutorial URLs (for both Visual Studio and Visual Studio Code) to the new consolidated tutorial URLs, ensuring backward compatibility for existing links.

4. TOC restructure

  • Consolidated the separate sections for Visual Studio and Visual Studio Code and reordered other tutorials.

Fixes #51451


Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
docs/core/apps.md Build apps with .NET
docs/core/deploying/index.md .NET application publishing overview
docs/core/diagnostics/managed-debuggers.md Managed debuggers - .NET Core
docs/core/install/linux-alpine.md Install the .NET SDK or the .NET Runtime on Alpine
docs/core/install/linux-debian.md [.NET 10](https://review.learn.microsoft.com/en-us/dotnet/core/install/linux-debian?branch=pr-en-us-51719)
docs/core/install/linux-fedora.md docs/core/install/linux-fedora
docs/core/install/linux-opensuse.md Install the .NET SDK or the .NET Runtime on openSUSE Leap
docs/core/install/linux-rhel.md Install .NET on RHEL and CentOS Stream
docs/core/install/linux-scripted-manual.md Install .NET on Linux by using an install script or by extracting binaries
docs/core/install/linux-sles.md [.NET 10](https://review.learn.microsoft.com/en-us/dotnet/core/install/linux-sles?branch=pr-en-us-51719)
docs/core/install/linux-snap-sdk.md docs/core/install/linux-snap-sdk
docs/core/install/linux-ubuntu-decision.md Install .NET on Ubuntu decision guide
docs/core/install/linux-ubuntu-install.md [.NET 10](https://review.learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu-install?branch=pr-en-us-51719)
docs/core/install/macos.md Install .NET on macOS
docs/core/install/windows.md Install .NET on Windows
docs/core/tutorials/create-console-app.md docs/core/tutorials/create-console-app
docs/core/tutorials/index.md Learn .NET and the .NET SDK tools by exploring these tutorials
docs/core/tutorials/libraries.md Develop libraries with the .NET CLI
docs/core/tutorials/publish-console-app.md Tutorial: Publish a .NET console application
docs/core/tutorials/testing-with-cli.md docs/core/tutorials/testing-with-cli
docs/csharp/fundamentals/program-structure/main-command-line.md Main() and command-line arguments
docs/fundamentals/index.yml .NET fundamentals documentation
docs/fundamentals/toc.yml docs/fundamentals/toc
docs/iot/tutorials/adc.md Read values from an analog-to-digital converter
docs/iot/tutorials/blink-led.md Blink an LED
docs/iot/tutorials/gpio-input.md Use GPIO for binary input
docs/orleans/tutorials-and-samples/tutorial-1.md docs/orleans/tutorials-and-samples/tutorial-1
docs/samples-and-tutorials/index.md .NET samples and tutorials
docs/standard/get-started.md Tutorials for getting started with .NET
docs/visual-basic/getting-started/index.md Get started with Visual Basic

Note

This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select OpenPublishing.Build Details within checks.

@meaghanlewis meaghanlewis requested a review from a team as a code owner February 12, 2026 20:28
Copilot AI review requested due to automatic review settings February 12, 2026 20:28
@dotnetrepoman dotnetrepoman bot added this to the February 2026 milestone Feb 12, 2026
@meaghanlewis meaghanlewis marked this pull request as draft February 12, 2026 20:28
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR consolidates the console app tutorial series into IDE-selectable zone pivots (Visual Studio, Visual Studio Code, and GitHub Codespaces), and removes the separate Visual Studio and Visual Studio Code tutorial branches.

Changes:

  • Adds a Visual Studio pivot to the shared code-editor-set-one pivot group and updates tutorials to use zone_pivot_groups.
  • Replaces the older “with-visual-studio*” tutorial pages with consolidated pivoted pages (console-app*, debugging-console-app, publishing-console-app, and new library/testing pages).
  • Updates the Fundamentals TOC and landing pages, and adds redirections from removed tutorial files to the new consolidated pages.

Reviewed changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
docs/zone-pivot-groups.yml Adds visualstudio to the code editor pivot group so tutorials can pivot by IDE.
docs/standard/get-started.md Updates “getting started” tutorial links to point at consolidated tutorial pages.
docs/fundamentals/toc.yml Removes IDE-specific tutorial subtrees and points directly to consolidated tutorial pages.
docs/fundamentals/index.yml Updates landing page tutorial link to consolidated “Hello World” tutorial.
docs/core/tutorials/index.md Updates tutorial index to list consolidated/pivoted tutorial pages and retains F# links.
docs/core/tutorials/console-app.md Converts the console app tutorial to a pivoted (VS/VS Code/Codespaces) article.
docs/core/tutorials/debugging-console-app.md Converts debugging tutorial content into a pivoted article and updates prerequisite link.
docs/core/tutorials/publishing-console-app.md Converts publishing tutorial content into a pivoted article and updates prerequisite/next-step links.
docs/core/tutorials/console-app-class-library.md Adds a new consolidated class library tutorial with IDE pivots.
docs/core/tutorials/testing-console-app-class-library.md Adds a new consolidated testing tutorial with IDE pivots.
docs/core/tutorials/with-visual-studio.md Removed (superseded by pivoted console-app.md).
docs/core/tutorials/debugging-with-visual-studio.md Removed (superseded by pivoted debugging-console-app.md).
docs/core/tutorials/publishing-with-visual-studio.md Removed (superseded by pivoted publishing-console-app.md).
docs/core/tutorials/library-with-visual-studio.md Removed (superseded by pivoted console-app-class-library.md).
docs/core/tutorials/testing-library-with-visual-studio.md Removed (superseded by pivoted testing-console-app-class-library.md).
docs/core/tutorials/library-with-visual-studio-code.md Removed (superseded by pivoted console-app-class-library.md).
docs/core/tutorials/testing-library-with-visual-studio-code.md Removed (superseded by pivoted testing-console-app-class-library.md).
.openpublishing.redirection.json Adds redirects from removed tutorial file paths to the new consolidated tutorial URLs.
Comments suppressed due to low confidence (1)

docs/core/tutorials/console-app.md:96

  • Extra space in "dialog, enter". Remove the double space.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add Visual Studio zone-pivot for console application tutorial series

1 participant

Comments