Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 7, 2026

Adds aspnetcore-10.0 moniker section to the "Get started with Razor Pages" tutorial per issue requirements.

Changes

This pull request updates the Razor Pages tutorial content and related includes to target ASP.NET Core 10.0, modernizes screenshots and code samples, and improves consistency and clarity across documentation. It also removes obsolete .NET 10 validation package information and updates prerequisites for Visual Studio and Visual Studio Code. The most important changes are outlined below.

Tutorial and Documentation Updates for ASP.NET Core 10.0:

  • Updated moniker ranges, code samples, and screenshots throughout the Razor Pages tutorial (da1.md, model.md, and related includes) to use ASP.NET Core 10.0 and Visual Studio 2026, ensuring all instructions and visuals reflect the latest version. [1] [2] [3] [4] [5] [6] [7] [8] [9]

  • Added a new include file (da1-9.md) and adjusted main tutorial files to separate instructions for ASP.NET Core 9.0 and 10.0, improving clarity for users on different versions. [1] [2]

Content and Language Improvements:

  • Revised explanations, instructions, and terminology for greater clarity and consistency, including changes to how model binding, data annotations, and concurrency handling are described. [1] [2] [3] [4]

  • Updated and replaced screenshots to match the new Visual Studio 2026 interface and ASP.NET Core 10.0 project structure. [1] [2] [3]

Prerequisite and Versioning Updates:

  • Updated Visual Studio and SDK prerequisites in the relevant include files to reference Visual Studio 2026 and .NET 10.0 SDK. [1] [2]

Removal of Obsolete Content:

  • Removed the .NET 10 validation package information include, as this content is no longer relevant for the updated documentation set.

Metadata and Date Updates:

  • Updated metadata dates in tutorial files to reflect the new publication and revision dates for 2026. [1] [2] [3]

These changes collectively ensure that the tutorials and supporting documentation are accurate, up-to-date, and easier to follow for users working with the latest version of ASP.NET Core and Visual Studio.

Original prompt

This section details on the original issue you should resolve

<issue_title>Use the latest version of .NET and Visual Studio in Get started with Razor Pages</issue_title>
<issue_description>### Description

Update: Tutorial: Get started with Razor Pages in ASP.NET Core to use:

  • .NET 10
  • Visual Studio 2026
  • Latest screenshots from VS Code and Visual Studio 2026

Page URL

https://learn.microsoft.com/en-us/aspnet/core/tutorials/razor-pages/razor-pages-start?view=aspnetcore-10.0&tabs=visual-studio

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/tutorials/razor-pages/razor-pages-start.md

Document ID

5492c641-af15-64b8-beaa-ddf511be73e6

Platform Id

b171f3de-4520-63d4-7b45-da14e27322a8

Article author

@wadepickett

Metadata

  • ID: a25bf940-8977-fec4-461b-542a9f550fc8
  • PlatformId: b171f3de-4520-63d4-7b45-da14e27322a8
  • Service: aspnet-core
  • Sub-service: tutorials

Related Issues</issue_description>

Comments on the Issue (you are @copilot in this section)

@wadepickett Thanks @meaghanlewis, I assigned to you, but if you did not intend to take it, no worried, you can assign to me in that case.

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.


Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
aspnetcore/tutorials/razor-pages/da1.md Part 5, update the generated pages in an ASP.NET Core app
aspnetcore/tutorials/razor-pages/index.md Tutorial: Create a Razor Pages web app with ASP.NET Core
aspnetcore/tutorials/razor-pages/model.md [Visual Studio](https://review.learn.microsoft.com/en-us/aspnet/core/tutorials/razor-pages/model?branch=pr-en-us-36590)
aspnetcore/tutorials/razor-pages/new-field.md [Visual Studio](https://review.learn.microsoft.com/en-us/aspnet/core/tutorials/razor-pages/new-field?branch=pr-en-us-36590)
aspnetcore/tutorials/razor-pages/page.md [Visual Studio](https://review.learn.microsoft.com/en-us/aspnet/core/tutorials/razor-pages/page?branch=pr-en-us-36590)
aspnetcore/tutorials/razor-pages/razor-pages-start.md "Tutorial: Get started with Razor Pages in ASP.NET Core"
aspnetcore/tutorials/razor-pages/razor-pages-start/sample/RazorPagesMovie10/wwwroot/lib/jquery-validation/LICENSE.md aspnetcore/tutorials/razor-pages/razor-pages-start/sample/RazorPagesMovie10/wwwroot/lib/jquery-validation/LICENSE
aspnetcore/tutorials/razor-pages/razor-pages-start/snapshot-sample10/wwwroot/lib/jquery-validation/LICENSE.md aspnetcore/tutorials/razor-pages/razor-pages-start/snapshot-sample10/wwwroot/lib/jquery-validation/LICENSE
aspnetcore/tutorials/razor-pages/search.md Part 6, add search to ASP.NET Core Razor Pages
aspnetcore/tutorials/razor-pages/sql.md [Visual Studio](https://review.learn.microsoft.com/en-us/aspnet/core/tutorials/razor-pages/sql?branch=pr-en-us-36590)
aspnetcore/tutorials/razor-pages/validation.md [Visual Studio](https://review.learn.microsoft.com/en-us/aspnet/core/tutorials/razor-pages/validation?branch=pr-en-us-36590)

Copilot AI changed the title [WIP] Update tutorial to use .NET 10 and Visual Studio 2026 Add .NET 10 and Visual Studio 2026 moniker section to Razor Pages tutorial Jan 7, 2026
Copilot AI requested a review from meaghanlewis January 7, 2026 18:41
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 pull request updates the Razor Pages "Get started" tutorial to support .NET 10 and Visual Studio 2026. The changes add a new moniker range for aspnetcore-10.0, update code samples, replace screenshots with 2026 versions, and modernize language throughout the tutorial for improved clarity.

Changes:

  • Added aspnetcore-10.0 moniker sections to validation, SQL, and search tutorial pages with updated content
  • Updated metadata dates to 01/09/2026 and replaced code sample references to use snapshot-sample10
  • Replaced Visual Studio screenshots with 2026 versions and updated image paths

Reviewed changes

Copilot reviewed 112 out of 173 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
validation.md Added .NET 10 validation package information and moniker section with modernized language
validation9.md New include file containing aspnetcore-9.0 specific content
sql.md Updated for .NET 10 with new screenshots and improved clarity
sql9.md New include file for aspnetcore-9.0 SQL content
search9.md New include file for aspnetcore-9.0 search functionality
validation-errors.png New validation error screenshot
sql/media/*.png Three new Visual Studio 2026 screenshots
snapshot-sample10/wwwroot/lib/* License files for jQuery libraries
site.js New JavaScript file for snapshot-sample10
Files not reviewed (5)
  • aspnetcore/tutorials/razor-pages/razor-pages-start/sample/RazorPagesMovie10/Migrations/20240613200303_InitialCreate.Designer.cs: Language not supported
  • aspnetcore/tutorials/razor-pages/razor-pages-start/sample/RazorPagesMovie10/Migrations/20240623214222_Rating.Designer.cs: Language not supported
  • aspnetcore/tutorials/razor-pages/razor-pages-start/sample/RazorPagesMovie10/Migrations/20240623215214_RatingTwo.Designer.cs: Language not supported
  • aspnetcore/tutorials/razor-pages/razor-pages-start/snapshot-sample10/Migrations/20230606012811_New_DataAnnotations.Designer.cs: Language not supported
  • aspnetcore/tutorials/razor-pages/razor-pages-start/snapshot-sample10/Migrations/20240613200303_InitialCreate.Designer.cs: Language not supported

@wadepickett
Copy link
Contributor

@wadepickett
Copy link
Contributor

wadepickett commented Jan 15, 2026

Review feedback, screen images:
There are a couple of screenshots that are missing a grey border so they don't bleed into the background page, here are a couple of examples, you might recheck through the series:
1st tutorial: Internal Preview: Overview

Screenshot of Edit page needs a grey border around the entire image when it has white area that bleeds to the rest of the page as seen on the rigth side here:
image

2nd tutorial: Internal Preview: Get Started

  1. Screensot of the ASP.NET web development workload option:
image

Nice to have a red border like this so it is quick to spot:
image

However, kind of a minor nit since it does have a check box checked. A little hard to see though. Your call.

Here are some of my own reminder notes on doing borders that might be of help:
• Grey 2 pixel border on white screenshot value is C3C3C3. (Make sure antialiasing is off which gives clean line.)
• Red 3 pixel border to point out buttons and fields use color EF1B36
• Screensize, 1200 max, (I usually go with 1000). Reduce the images size if needed before doing grey and red borders so your added borders to not shrink and nearly disapeer.

  • Screenshots should also use the default color theme of Visual Studio, which is Dark for VS 2026. This is so folks just getting started with VS and their first ASP.NET Core app see exactly in the tutorial what they have on their screen by default. It makes it faster for them to visualy compare what is required and have some confidence they have exactly what they need for set up.

@wadepickett
Copy link
Contributor

wadepickett commented Jan 15, 2026

  • In the "Work with a databse" tutorial, the screenshot /movie-table-in-designer-vs2026.png and the sreenshot /edit-movie.png need a grey border around each.
  • In the "Update the pages" tuorial, the screenshot /seed-data-in-app.png needs a grey boarder around it.

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.

Great work! There were a few item to fix that I noted. Overall though, it looks great and you made some nice improvements along the way. :)

@meaghanlewis
Copy link
Collaborator

@wadepickett thanks for your review. I've updated all the images, so that they now have the proper border, correct dimensions, and all the VS2026 screenshots are now in dark mode. I also updated the syntax error in the code sample.

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.

Use the latest version of .NET and Visual Studio in Get started with Razor Pages

3 participants