IHostApplicationLifetime documentation on released artifacts does not match source

[penenkel]

Perhaps I'm am missing something obvious here, but I noticed, that the doc-comment on IHostApplicationLifetime.ApplicationStopping in the current artifacts does not match the one that is present in the source code.

With current artifacts I am referring to https://www.nuget.org/packages/Microsoft.Extensions.Hosting.Abstractions/5.0.0
and also https://docs.microsoft.com/en-us/dotnet/api/microsoft.extensions.hosting.ihostapplicationlifetime?view=dotnet-plat-ext-5.0.

I am comparing this to the source at https://github.com/dotnet/runtime/blob/main/src/libraries/Microsoft.Extensions.Hosting.Abstractions/src/IHostApplicationLifetime.cs. Which has not changed (in a relevant manner) since Feb 13, 2020. Those changes were triggered by dotnet/extensions#2962 and merged in dotnet/extensions#2963. All well before version 5.0 was released.

As far as I can tell the issue is still present in https://www.nuget.org/packages/Microsoft.Extensions.Hosting.Abstractions/6.0.0-preview.1.21102.12.

Tagging subscribers to this area: @eerhardt, @maryamariyan
See info in area-owners.md if you want to be subscribed.

Issue Details

---

Perhaps I'm am missing something obvious here, but I noticed, that the doc-comment on IHostApplicationLifetime.ApplicationStopping in the current artifacts does not match the one that is present in the source code.

With current artifacts I am referring to https://www.nuget.org/packages/Microsoft.Extensions.Hosting.Abstractions/5.0.0
and also https://docs.microsoft.com/en-us/dotnet/api/microsoft.extensions.hosting.ihostapplicationlifetime?view=dotnet-plat-ext-5.0.

I am comparing this to the source at https://github.com/dotnet/runtime/blob/main/src/libraries/Microsoft.Extensions.Hosting.Abstractions/src/IHostApplicationLifetime.cs. Which has not changed (in a relevant manner) since Feb 13, 2020. Those changes were triggered by dotnet/extensions#2962 and merged in dotnet/extensions#2963. All well before version 5.0 was released.

As far as I can tell the issue is still present in https://www.nuget.org/packages/Microsoft.Extensions.Hosting.Abstractions/6.0.0-preview.1.21102.12.

Author:	penenkel
Assignees:	-
Labels:	area-Extensions-Hosting, untriaged
Milestone:	-

I couldn't figure out the best area label to add to this issue. If you have write-permissions please help me learn by adding exactly one area label.

[maryamariyan]

Good catch!

It seems like the merged extensions PR from Feb 2020 (dotnet/extensions#2963) updated the dotnet/runtime triple slash docs, but since dotnet/dotnet-api-docs is the source of truth for docs and at the moment, what you see in the docs page is the out of date content.

Would you like to open up a PR to fix that? It should be as easy as clicking on Edit on the top right of the docs page here

[penenkel]

Are all those .xml files hand-written? I would have expected them to be auto-generated from doc-comments like they usually are. Don't you have some kind of process to regenerate them periodically?

[maryamariyan]

/cc @carlossanlop who is more up to date on where we are with syncing triple slash comments in source code and the content in this docs repo.