tldr; This is a status update on the .NET documentation. If you want me to do more of those (once a month), please let me know in the comments!

NOTE: .NET Core 3.0 will be released at .NET Conf. That starts on September 23rd 2019. The conference is online and you’ll be able to ask questions. Please consider attending!

Hi everyone!

This is the third month where I post a summary of all .NET-related documentation that were significantly updated during the month of August.

My name is Maxime Rouiller and I’m a Cloud Advocate with Microsoft. For this month, I’m covering three major products:

• .NET, which had ~249 commits, and 4,247 changed files on their docs repository and ~184 PRs on their API docs repository
• ASP.NET, which had ~269 commits, and 1,615 changed files on their docs repository
• NuGet, which had ~136 commits, and 85 changed files on their docs repository

Obviously, that’s a lot of changes and I’m to help you find the gold within this tsunami of changes.

So here are all the documentation updates by product with commentary when available!

Themes this month

• What’s new for the Preview 8
• Updating the CLI documentation
• Adding new tab on the hub to better find e-books
• Removing duplicate articles
• Updating C# 8:
  • Nullable types
  • Default interface
  • Reference page

.NET Core

There was this addition that was made this month:

• DateTime and DateTimeOffset support in System.Text.Json

Another VERY interesting article that was updated this month is a guidance article on cross-platform targeting! Now with more code sample!

• Cross-platform targeting for .NET libraries

The telemetry article has been thoroughly revised and now includes a link for you to see the telemetry data for the past quarter (Q2):

• .NET Core SDK telemetry

The .NET Standard support table was updated to include the 2.1 Preview information:

• .NET Standard

Dependency Loading

All of the following are brand new .NET Core articles:

• Default probing
• Managed assembly loading algorithm
• Satellite assembly loading algorithm
• Unmanaged library loading algorithm
• Dependency loading
• Understanding AssemblyLoadContext

Diagnostics

Brand new articles on the available diagnostic tools within .NET Core. From managed debuggers, logging, tracing, and unit testing:

• Diagnostics tools overview
• Logging and tracing
• Managed debuggers

ML.NET

New tutorial for developing an ONNX model to detect objects in images:

• Detect images in objects

Articles on Model Builder and ML.NET CLI are now in the main table of contents under Tools sections:

• Tools table of contents

There was a small but important bug fix to the ML.NET CLI telemetry article to fix the environment variable name to opt out of telemetry:

• Telemetry collection by the ML.NET CLI

.NET for Apache Spark

A new tutorial was added based on a customer suggestion:

• Debug a .NET for Apache Spark application on Windows

.NET APIs

.NET Core 3.0 Preview 8 was launched on August 14th, so the API reference documentation for .NET Core and .NET Platform Extensions 3.0 was updated. The API documentation was also updated to include a new version of .NET Standard 2.1 Preview.
The documentation team is also working closely with the .NET developer team to add more API documentation for .NET Core 3.0. We reduced the number of undocumented APIs by 1,336 in August.

Do you want to watch what’s going on? Follow the .NET APIs Docs repository!

ASP.NET Core

Fundamentals

• Localization Extensibility
  • Brand new article!
• File Providers in ASP.NET Core
  • New sections, worth revisiting
• High-performance logging with LoggerMessage in ASP.NET Core
  • This whole page had many paragraphs added, sample code added, must read.
• URL Rewriting Middleware in ASP.NET Core
  • This article was completely rewritten for 3.0.
• Options pattern in ASP.NET Core
  • All the samples were updated to 3.0, section added for 2.2
• Logging in .NET Core and ASP.NET Core
  • Revamped for 3.0.
• Configuration in ASP.NET Core
  • Default Configuration section completely rewritten for 3.0. Lots of sample code has also been cleaned up.
• App startup in ASP.NET Core
  • Revamped for 3.0.
• Make HTTP requests using IHttpClientFactory in ASP.NET Core
  • added how to use IHttpClientFactory in a console app, lots of cleanup.

Performance

• Cache in-memory in ASP.NET Core
• Response Caching Middleware in ASP.NET Core

Security

• Hosting ASP.NET Core Images with Docker over HTTPS
• Authentication samples for ASP.NET Core

gRPC

• Troubleshoot gRPC on .NET Core
  • brand new article on troubleshooting gRPC issues including a section on macOS, untrusted certificates, and more.
• gRPC services with ASP.NET Core
  • added a whole section on configuring gRPC with Kestrel, HTTP/2, and HTTPS

SignalR

• ASP.NET Core SignalR configuration
  • Added configuration options for all languages, simplified language in some option description.

Blazor

Do I need to mention that those are all must reads?

• ASP.NET Core Blazor state management
  • brand new article on Blazor state management!

• Handle errors in ASP.NET Core Blazor apps

  • brand new article on error handling with Blazor!

• Create and use ASP.NET Core Razor components

  • This page received massive amount of changes with updates from the latest previews including a section on globalization, localization, and ample links to the proper APIs/methods/objects have been added.
• ASP.NET Core Blazor JavaScript interop
  • brand new section on the IJSRuntime w/code sample has been added.

Razor Pages

• Migrate from ASP.NET Core 2.2 to 3.0 Preview
  • Updated the migration page for the latest Preview changes.
• ASP.NET Core Razor SDK
  • Updated for .NET Core 3.0 latest changes
• Reusable Razor UI in class libraries with ASP.NET Core
  • Added section on Typescript integration, excluding static assets
• Razor Pages route and app conventions in ASP.NET Core
  • Updated for the latest changes, added code snippets.
• Razor Pages unit tests in ASP.NET Core
  • Updated samples, completely rewritten for 3.0.

Razor Pages with EF Core in ASP.NET Core Tutorial

This whole tutorial was updated to 3.0 and got good changes to review. Worth going through again!

• Razor Pages with Entity Framework Core in ASP.NET Core - Tutorial 1 of 8
• Razor Pages with EF Core in ASP.NET Core - CRUD - 2 of 8
• Razor Pages with EF Core in ASP.NET Core - Sort, Filter, Paging - 3 of 8
• Razor Pages with EF Core in ASP.NET Core - Migrations - 4 of 8
• Razor Pages with EF Core in ASP.NET Core - Data Model - 5 of 8
• Razor Pages with EF Core in ASP.NET Core - Read Related Data - 6 of 8
• Razor Pages with EF Core in ASP.NET Core - Update Related Data - 7 of 8
• Razor Pages with EF Core in ASP.NET Core - Concurrency - 8 of 8

Tutorials, HowTo, guides, and others

Two brand new tutorials this month.

• Tutorial: Call an ASP.NET Core web API with JavaScript
• Publish an ASP.NET Core app to IIS

All the following tutorials were updated to .NET Core 3.0.

• Get started with Swashbuckle and ASP.NET Core
• Create a web API with ASP.NET Core and MongoDB
• Work with SQL in an ASP.NET Core MVC app
• Add a model to an ASP.NET Core MVC app
• Add validation to an ASP.NET Core Razor Page

NuGet

• Create a NuGet package using MSBuild
  • New page added that guides you through the process of creating a NuGet package with only MSBUILD.
• Multi-targeting for NuGet Packages
  • Fixed issue #1544 which adds how to create dependency groups.
• nuget.config File Reference
  • Added fallbackPackageFolders section. Added packageManagement settings, fixing issue #1279.
• .nuspec File Reference for NuGet
  • Tons of smaller adjustement to the specification. Issues fixed: #1135, #1051, #1450, #1318, #1093.
• NuGet Package Restore
  • This page was mostly rewritten while keeping the Table Of Content mostly intact. Important additions includes: different way to restore packages using MSBUILD, the .NET CLI, Azure Pipelines, and Azure DevOps Server.
• Create a NuGet package using the dotnet CLI
  • Added csproj samples, fixed typos, Removed content that belongs to another page.