Part 6, controller methods and views in ASP.NET Core

[snehansh]

Description

On Page
There is a text at the beginning of the page:
We have a good start to the movie app, but the presentation isn't ideal, for example, ReleaseDate should be two words.

Below that there is an image.

I think in this screenshot you should be showing ReleaseDate as one column in the header as without the use of [Display(Name = "Release Date")] column header would have been ReleaseDate.
Also, the column values should have shown both Date and time.

Once you apply the DataAnnotations that are discussed after the screenshot you would get a screenshot which is what you have included right below first line on the page.

Please correct the image and use the right screenshot to illustrate the issues that later got resolved by the use of DataAnnotations.

Page URL

https://learn.microsoft.com/en-us/aspnet/core/tutorials/first-mvc-app/controller-methods-views?view=aspnetcore-10.0

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/tutorials/first-mvc-app/controller-methods-views.md

Document ID

51894773-82dc-3c71-f675-8af42cfa925f

Platform Id

31df6d9c-5b2c-e95c-0f13-1aa78ddeadbb

Article author

@wadepickett

Metadata

• ID: 582aeaf8-770f-6861-ab47-bb6a4f2206e4
• PlatformId: 31df6d9c-5b2c-e95c-0f13-1aa78ddeadbb
• Service: aspnet-core
• Sub-service: tutorials

Related Issues

[wadepickett]

Thanks @snehansh very much for pointing out this problem and providing a suggested fix. Greatly appreciated!

[wadepickett]

Test AI Analysis Report

Run by: @wadepickett
Date: 2025-11-18
Issue: #36359
Model: GitHub Copilot

Issue Analysis: Correct tutorial screenshot to properly demonstrate DataAnnotations impact on ReleaseDate column

✅ Issue Validation

Status: Valid and actionable

📋 Issue Summary

The user reports that in Part 6 of the ASP.NET Core "first MVC app" tutorial, the initial screenshot shown in the "controller methods and views" article illustrates a table in which the "ReleaseDate" column header is already split as "Release Date" and formatted with a date only, rather than showing the column header as "ReleaseDate" and displaying both date and time.

The tutorial narrative aims to demonstrate that applying [Display(Name = "Release Date")] and date formatting to the model changes both the column header and the value format. Thus, the initial screenshot should illustrate the unfixed state (i.e., column header as "ReleaseDate" and displaying both date and time). However, the screenshot currently reflects the fixed state, creating confusion and failing to show the intended before-and-after effect.

This issue is valid and aligns with best documentation practices of clearly illustrating what is being changed and why.

📁 Affected Files

File	Path	Lines	Section
Main article	aspnetcore/tutorials/first-mvc-app/controller-methods-views.md	approx. 15-45	"Add a View" introduction & screenshot section

The affected section is near the beginning, directly under the sentence:
"We have a good start to the movie app, but the presentation isn't ideal, for example, ReleaseDate should be two words."
See: https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/tutorials/first-mvc-app/controller-methods-views.md

📝 Proposed Changes

Documentation Updates

File: aspnetcore/tutorials/first-mvc-app/controller-methods-views.md
Location: Lines approx. 15-45, immediately below the introductory paragraph referencing "ReleaseDate".

Current content:

We have a good start to the movie app, but the presentation isn't ideal, for example, ReleaseDate should be two words.

![Image](https://github.com/user-attachments/assets/13ebc5a3-11d0-4650-83a5-dbab5db339d7)

Proposed change:

We have a good start to the movie app, but the presentation isn't ideal, for example, ReleaseDate should be two words.

<!-- Updated screenshot needed here: Should show the original (unfixed) UI with 'ReleaseDate' as a single column header and value displayed in date and time format. -->

![Screenshot showing 'ReleaseDate' column header and date/time values, before DataAnnotations are applied](URL_TO_NEW_SCREENSHOT_PLACEHOLDER)

[!NOTE]
The above screenshot illustrates the initial state before applying DataAnnotations to the model. Notice:
- The column header is "ReleaseDate" (not "Release Date")
- The values display both date and time

After applying `[Display(Name = "Release Date")]` and date formatting (shown below), the table will have a "Release Date" column header and the values will show only the date.

• Replace the current image and caption with a screenshot taken before DataAnnotations and formatting are applied, and add a short explanatory note as above.

If a separate "after" screenshot is used later in the article, ensure its placement remains correct and update captions for clarity.

Code Sample Updates

No code sample changes needed based on this issue, as the problem is solely with presentation of visuals and supporting explanation.

🎯 Action Plan

1. Replace Screenshot:

   • Take a screenshot of the app with the original model (before applying [Display(Name = "Release Date")] and date formatting).
     • Column header: "ReleaseDate"
     • Value format: date and time
   • Save and upload this image to the repo (or issue) and update the markdown image link in controller-methods-views.md.

2. Add Explanation:

   • Insert a [!NOTE] block underneath the image to explain what the screenshot demonstrates and why DataAnnotations are needed (see proposed text above).

3. Verify Sequence:

   • Review the tutorial flow and ensure the "after" screenshot (with "Release Date" and formatted value) remains in the right spot, after the section describing changes to the model.

4. Check Related Tutorials:

   • Optionally, review prior tutorial sections (start-mvc, adding-controller, etc.) for similar screenshot/explanation mismatches.

⚠️ Considerations

• Target .NET 10.0 documentation, confirm that all screenshots match the current tooling and UI.
• Clearly distinguish "before" and "after" states through both visuals and explanatory text.
• If the screenshots are generated programmatically, update sample output to match new image.
• Add ai-reviewed-issue-reported-action-plan label to the issue after posting this report.

🔗 References

• Published tutorial (part 6)
• Content source file
• Related issue #36359
• Microsoft Learn Docs (full tutorial TOC)

---

Full Tutorial Series Review

The full published tutorial series was reviewed up to the tutorial this issue is on, including:

• Getting started: Start MVC
• Adding a controller
• Adding a view
• Adding a model
• Working with SQL
• Controller methods and views

Validation findings:

• The reported issue applies specifically to Part 6 ("controller methods and views").
• The first screenshot in Part 6 still displays the corrected state (with "Release Date" and date-only values) instead of showing the uncorrected state (with "ReleaseDate" and date/time values), which matches the user's concern.
• The rest of the series does not show or rely on this specific screenshot or explanation, so my recommendations for updating the screenshot and adding clarifying context are still correct and only affect Part 6.

Summary:
No additional changes are needed in Parts 1-5 ("Start MVC", "Adding Controller", "Adding View", "Adding Model", "Working with SQL") based on this review. The recommendations remain valid and targeted only to Part 6.