Skip to content

Conversation

@guardrex
Copy link
Collaborator

@guardrex guardrex commented Jul 21, 2025

Fixes #35740

Notes

  • We're keeping the RP version for <8.0. However, I made a number of changes to modernize and improve the RP version.
  • I don't recommend the usual prereqs section approach, which goes quite stale ... as it did here! 😄 My approach hardens it for future releases.
  • Recommend separating the change directory (cd) command from the command that runs the app. Shells behave differently when multiple commands are pasted at once. My approach avoids 😈.
  • Let's use this teachable moment to cover some basic Razor component concepts. It immediately demos the great value of Blazor for client-side dev with C#. It's SO freak'in COOL! 😎
  • Let's cover shut down, too.
  • There are some _static files here that are ancient and defunct. Removing them here.
  • There are certificate images in the old getting-started folder for some reason. Moving them here.
  • I think this article is out of position in a getting-started folder. Moving it here.
  • New images! 🎉
  • No need for the CSHTML code file in the RP section. We just need to add a line after the "Welcome" line. Let's avoid the overhead of adding files when they aren't needed because this repo is bloated and slow to work with now.

Internal previews

📄 File 🔗 Preview link
aspnetcore/data/ef-rp/intro.md aspnetcore/data/ef-rp/intro
aspnetcore/fundamentals/servers/yarp/direct-forwarding.md aspnetcore/fundamentals/servers/yarp/direct-forwarding
aspnetcore/get-started.md aspnetcore/get-started
aspnetcore/index.yml aspnetcore/index
aspnetcore/introduction-to-aspnet-core.md aspnetcore/introduction-to-aspnet-core
aspnetcore/migration/1x-to-2x/index.md aspnetcore/migration/1x-to-2x/index
aspnetcore/toc.yml aspnetcore/toc
aspnetcore/tutorials/publish-to-iis.md aspnetcore/tutorials/publish-to-iis
aspnetcore/tutorials/razor-pages/razor-pages-start.md aspnetcore/tutorials/razor-pages/razor-pages-start
aspnetcore/whats-new/dotnet-AspNetCore.Docs-mod0.md aspnetcore/whats-new/dotnet-AspNetCore.Docs-mod0

@guardrex guardrex self-assigned this Jul 21, 2025
@guardrex guardrex requested a review from Copilot July 21, 2025 15:26

This comment was marked as outdated.

@guardrex guardrex requested a review from Copilot July 21, 2025 15:40

This comment was marked as outdated.

Copy link
Member

@danroth27 danroth27 left a comment

Choose a reason for hiding this comment

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

The changes to Blazor look good. You found a couple of mentions of Razor Pages that we'll want to clean up too, but it doesn't have to be in this PR.

@guardrex
Copy link
Collaborator Author

@danroth27 ... 👍 ... I'll open issues for anything that I can't fix quickly-ish. Images will go in tomorrow. I'll ping everyone for review.

@guardrex guardrex marked this pull request as ready for review July 22, 2025 14:15
@guardrex guardrex requested a review from Copilot July 22, 2025 14:24

This comment was marked as outdated.

@guardrex
Copy link
Collaborator Author

guardrex commented Jul 22, 2025

btw @tdykstra @wadepickett ... WRT the build report remark that ...

Invalid value for 'ms.author', 'samsp' is not a valid Microsoft alias.

Do we have a replacement? If so, I'll just stick it on this PR for that whole block of articles to silence this from popping up in the future.

... and that YARP article node is ... yikes! It needs work. I pinged on the YARP organizational issue about it. I can't fix those articles here.

Copy link
Member

@danroth27 danroth27 left a comment

Choose a reason for hiding this comment

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

:shipit:

Copy link
Contributor

@wadepickett wadepickett left a comment

Choose a reason for hiding this comment

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

@guardrex, looks great! I am not spotting any issues at all. Well done.

Copy link
Contributor

@tdykstra tdykstra left a comment

Choose a reason for hiding this comment

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

lookss great, just a few nit suggestions

@guardrex guardrex requested a review from Copilot July 23, 2025 19:24
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 updates the ASP.NET Core "Get started" tutorial by modernizing the content and reorganizing files. The changes replace the old Razor Pages-focused tutorial with a new Blazor Web App tutorial for ASP.NET Core 8.0+, while maintaining backward compatibility for earlier versions.

  • Consolidates the getting started content from a folder structure to a single file (get-started.md)
  • Updates the tutorial to focus on Blazor Web Apps for modern ASP.NET Core versions
  • Fixes broken image references by updating paths from ~/getting-started/_static/ to ~/static/

Reviewed Changes

Copilot reviewed 22 out of 40 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
aspnetcore/get-started.md New consolidated tutorial file with Blazor Web App focus for 8.0+ and Razor Pages for earlier versions
aspnetcore/getting-started/index.md Removes old tutorial file (replaced by get-started.md)
aspnetcore/getting-started/sample/Index.cshtml Removes sample file no longer needed
aspnetcore/whats-new/dotnet-AspNetCore.Docs-mod0.md Updates cross-reference from getting-started to get-started
Multiple include files Updates image paths from ~/getting-started/_static/ to ~/static/
.openpublishing.redirection.json Adds redirect from old getting-started path to new get-started path

@guardrex guardrex merged commit 38f05a0 into main Jul 23, 2025
3 checks passed
@guardrex guardrex deleted the guardrex/get-started-tutorial branch July 23, 2025 19:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update the ASP.NET Core "Get Started" tutorial to be based on Minimal APIs & Blazor

5 participants