Skip to content

Conversation

@gewarren
Copy link
Contributor

Contributes to dotnet/dotnet-api-docs#9989.

@gewarren gewarren changed the title More doc updates More doc updates for source-of-truth assemblies Sep 13, 2024
Copy link
Contributor

@carlossanlop carlossanlop left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed half of the files, until Microsoft.Extensions.FileProviders.

Next review starts at Microsoft.Extensions.Hosting.

@carlossanlop carlossanlop added area-Extensions-FileSystem area-Meta documentation Documentation bug or enhancement, does not impact product or test code and removed area-Extensions-Logging area-Extensions-FileSystem labels Sep 13, 2024
@dotnet-policy-service
Copy link
Contributor

Tagging subscribers to this area: @dotnet/area-meta
See info in area-owners.md if you want to be subscribed.

1 similar comment
@dotnet-policy-service
Copy link
Contributor

Tagging subscribers to this area: @dotnet/area-meta
See info in area-owners.md if you want to be subscribed.

Copy link
Contributor

@carlossanlop carlossanlop left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left some comments for you to consider, otherwise it LGTM.
I'll backport this to release/9.0 as well when you merge it.


/// <summary>
/// Name of the machine having the event log. If <c>null</c> or not specified, local machine is the default.
/// Gets or sets the name of the machine with the event log. If <see langword="null" /> or not specified, local machine is the default.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For consistency with the others:

Suggested change
/// Gets or sets the name of the machine with the event log. If <see langword="null" /> or not specified, local machine is the default.
/// Gets or sets the name of the machine with the event log. If <see langword="null" /> or not specified, "local machine" is the default.

@dotnet/area-extensions-logging does this default value begin in lowercase?

@carlossanlop
Copy link
Contributor

It would be nice to backport this to 9.0. Today's the snap for the RC2 branch but we still have time tomorrow before we start the builds. Would you mind looking at the feedback when you get a chance @gewarren?

Co-authored-by: Carlos Sánchez López <[email protected]>
@gewarren
Copy link
Contributor Author

@carlossanlop There seem to be a lot of errors. Is this okay to merge?

@gewarren gewarren merged commit 3baa42e into dotnet:main Sep 25, 2024
83 of 85 checks passed
@gewarren gewarren deleted the docs0913 branch September 25, 2024 16:39
@gewarren
Copy link
Contributor Author

@carlossanlop Can you backport this one please?

@carlossanlop
Copy link
Contributor

/backport to release/9.0

@github-actions
Copy link
Contributor

Started backporting to release/9.0: https://github.com/dotnet/runtime/actions/runs/11041750136

@github-actions
Copy link
Contributor

@carlossanlop backporting to release/9.0 failed, the patch most likely resulted in conflicts:

$ git am --3way --empty=keep --ignore-whitespace --keep-non-patch changes.patch

Applying: doc updates
Using index info to reconstruct a base tree...
M	src/libraries/Microsoft.Extensions.FileProviders.Abstractions/src/IFileProvider.cs
M	src/libraries/Microsoft.Extensions.FileProviders.Composite/src/CompositeFileProvider.cs
M	src/libraries/Microsoft.Extensions.FileProviders.Physical/src/PhysicalFileProvider.cs
M	src/libraries/Microsoft.Extensions.FileProviders.Physical/src/PhysicalFilesWatcher.cs
M	src/libraries/Microsoft.Extensions.Hosting/src/HostingHostBuilderExtensions.cs
M	src/libraries/Microsoft.Extensions.Primitives/src/StringValues.cs
Falling back to patching base and 3-way merge...
Auto-merging src/libraries/Microsoft.Extensions.Primitives/src/StringValues.cs
CONFLICT (content): Merge conflict in src/libraries/Microsoft.Extensions.Primitives/src/StringValues.cs
Auto-merging src/libraries/Microsoft.Extensions.Hosting/src/HostingHostBuilderExtensions.cs
Auto-merging src/libraries/Microsoft.Extensions.FileProviders.Physical/src/PhysicalFilesWatcher.cs
Auto-merging src/libraries/Microsoft.Extensions.FileProviders.Physical/src/PhysicalFileProvider.cs
Auto-merging src/libraries/Microsoft.Extensions.FileProviders.Composite/src/CompositeFileProvider.cs
CONFLICT (content): Merge conflict in src/libraries/Microsoft.Extensions.FileProviders.Composite/src/CompositeFileProvider.cs
Auto-merging src/libraries/Microsoft.Extensions.FileProviders.Abstractions/src/IFileProvider.cs
CONFLICT (content): Merge conflict in src/libraries/Microsoft.Extensions.FileProviders.Abstractions/src/IFileProvider.cs
error: Failed to merge in the changes.
hint: Use 'git am --show-current-patch=diff' to see the failed patch
hint: When you have resolved this problem, run "git am --continue".
hint: If you prefer to skip this patch, run "git am --skip" instead.
hint: To restore the original branch and stop patching, run "git am --abort".
hint: Disable this message with "git config advice.mergeConflict false"
Patch failed at 0001 doc updates
Error: The process '/usr/bin/git' failed with exit code 128

Please backport manually!

@github-actions
Copy link
Contributor

@carlossanlop an error occurred while backporting to release/9.0, please check the run log for details!

Error: git am failed, most likely due to a merge conflict.

carlossanlop added a commit that referenced this pull request Sep 26, 2024
sirntar pushed a commit to sirntar/runtime that referenced this pull request Sep 30, 2024
@github-actions github-actions bot locked and limited conversation to collaborators Oct 26, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

area-Meta documentation Documentation bug or enhancement, does not impact product or test code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants