Skip to content

update first-mono-app to .NET 10#37104

Open
timdeschryver wants to merge 6 commits into
dotnet:mainfrom
timdeschryver:issue/37075
Open

update first-mono-app to .NET 10#37104
timdeschryver wants to merge 6 commits into
dotnet:mainfrom
timdeschryver:issue/37075

Conversation

@timdeschryver
Copy link
Copy Markdown
Contributor

@timdeschryver timdeschryver commented May 5, 2026

Closes #37075
See comments for some more info about the changes.

If required, I can also provide a .NET 11 example (there won't be an impact on this example so far AFAIK).

Additionally, I noticed copilot providing the following feedback, should I also change this?

Several placeholders use angle-bracket style (for example, <port>, <user>, <version_number>, <data_directory_path>) instead of the required brace placeholder style.

Use this pattern for placeholders: {PLACEHOLDER NAME} (uppercase words, spaces allowed inside braces).

Specific bad vs good examples:

Bad: https://localhost:<port>/openapi/v1.json
Good: https://localhost:{PORT}/openapi/v1.json

Bad: C:\Users\<user>\AppData\Local\Programs\mongosh
Good: C:\Users\{USER NAME}\AppData\Local\Programs\mongosh

Bad: C:\Program Files\MongoDB\Server\<version_number>\bin
Good: C:\Program Files\MongoDB\Server\{VERSION NUMBER}\bin

Bad: mongod --dbpath <data_directory_path>
Good: mongod --dbpath {DATA DIRECTORY PATH}

Internal previews

📄 File 🔗 Preview link
aspnetcore/tutorials/first-mongo-app.md Create a web API with ASP.NET Core and MongoDB

Comment thread aspnetcore/includes/duende-identity-server-10.md
Comment thread aspnetcore/tutorials/first-mongo-app.md
Comment thread aspnetcore/tutorials/first-mongo-app.md
Comment thread aspnetcore/tutorials/first-mongo-app.md
Comment thread aspnetcore/tutorials/first-mongo-app.md
Comment thread aspnetcore/tutorials/first-mongo-app.md Outdated
Comment thread aspnetcore/tutorials/first-mongo-app.md Outdated
@wadepickett
Copy link
Copy Markdown
Contributor

wadepickett commented May 5, 2026

@timdeschryver, thanks again for taking this on!

For the question on brackets for placeholders. Yes, this below is the latest guildeline to follow:
Use this pattern for placeholders: {PLACEHOLDER NAME} (uppercase words, spaces allowed inside braces).
Bad: https://localhost:/openapi/v1.json
Good: https://localhost:{PORT}/openapi/v1.json

For .NET 11: if you would like to provide a .NET 11 version that sounds great. Not required though! I don't think there would be much of a difference at all, but .NET 11 and VS are still a potential moving target until the release.

At the moment the only articles we are actively updating are ones effected by .NET 11 related features or feature changes that need to be represented as a priority.

@wadepickett
Copy link
Copy Markdown
Contributor

Code snippets links for v9 are resulting in build errors:
Line 168: [Warning] The code snippet "first-mongo-app/samples_snapshot/9.x/Book.cs" could not be found.

@timdeschryver
Copy link
Copy Markdown
Contributor Author

Code snippets links for v9 are resulting in build errors: Line 168: [Warning] The code snippet "first-mongo-app/samples_snapshot/9.x/Book.cs" could not be found.

Thanks, good catch. This should be resolved with the latest commit.

@wadepickett
Copy link
Copy Markdown
Contributor

wadepickett commented May 6, 2026

@timdeschryver,
There are some new file name requirements. They get flagged as build warning. (Not my requirements, but they are required now for all docs.)

Filenames like this:
aspnetcore/includes/DuendeIdentityServer-10.x.md

Have to have whole words, can't have a period in the name.
aspnetcore/includes/duende-identity-server-10.md

also this one:
aspnetcore/tutorials/first-mongo-app/includes/first-mongo-app9.md

would have to be:
aspnetcore/tutorials/first-mongo-app/includes/first-mongo-app-9.md

Select "OpenPublishing.Build" near the bottom of the PR to see the warning details:
image

Copy link
Copy Markdown
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.

Approved.

@wadepickett
Copy link
Copy Markdown
Contributor

wadepickett commented May 8, 2026

@timdeschryver, excellent work on a complete article + code rewrite! Greatly appreciated!

We have been removing "by author" lines from articles, but this one still has one. I think you re-designed/re-wrote/re-coded this one enough that you should be considered author. We can't do this all the time, (I don't even get one these days), but I would be happy to put a "by Tim Deschryver" on this essentially new article. If that is OK, what link do you want, if any for your name?

@wadepickett wadepickett self-assigned this May 11, 2026
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.

Minimal API with MongoDB: Update for .NET 10, VS 2026, latest VS, MongoDB 8.5 redo for Min API

2 participants