Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

System.Linq: Backport MS Docs documentation to triple slash #48986

Closed
carlossanlop opened this issue Mar 2, 2021 · 3 comments
Closed

System.Linq: Backport MS Docs documentation to triple slash #48986

carlossanlop opened this issue Mar 2, 2021 · 3 comments
Assignees
Labels
area-System.Linq documentation Documentation bug or enhancement, does not impact product or test code
Milestone

Comments

@carlossanlop
Copy link
Member

We are working on a new documentation process plan, in which the main objective is to make triple slash comments the source of truth for documentation, instead of MS Docs: We want developers/maintainers to have an easier time maintaining the documentation for their APIs.

You can use the DocsPortingTool to automate the backport process: Run the tool targeting the assembly, then submit a PR with the changes.

You can find detailed instructions for the backporting process here.

Area owners are free to decide if they want to address this in 6.0 or in Future.

@carlossanlop carlossanlop added documentation Documentation bug or enhancement, does not impact product or test code area-System.Linq labels Mar 2, 2021
@carlossanlop carlossanlop added this to To do in Documentation backport via automation Mar 2, 2021
@dotnet-issue-labeler dotnet-issue-labeler bot added the untriaged New issue has not been triaged by the area owner label Mar 2, 2021
@ghost
Copy link

ghost commented Mar 2, 2021

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

Issue Details

We are working on a new documentation process plan, in which the main objective is to make triple slash comments the source of truth for documentation, instead of MS Docs: We want developers/maintainers to have an easier time maintaining the documentation for their APIs.

You can use the DocsPortingTool to automate the backport process: Run the tool targeting the assembly, then submit a PR with the changes.

You can find detailed instructions for the backporting process here.

Area owners are free to decide if they want to address this in 6.0 or in Future.

Author: carlossanlop
Assignees: -
Labels:

area-System.Linq, documentation

Milestone: -

@carlossanlop
Copy link
Member Author

@eiriktsarpalis Can I assume that we can include in this issue all the APIs that belong to area-System.Linq.Expressions? I ask because I did not see that area explicitly mentioned in the document with area pod ownership.

@jeffhandley
Copy link
Member

We are closing all of the issues for backporting api docs to triple-slash comments for now. We concluded early in the .NET 7.0 release cycle that we need to invest more into the DocsPortingTool to set this effort up for success. When we're able to revisit this, we will open new issues per area again.

@jeffhandley jeffhandley closed this as not planned Won't fix, can't repro, duplicate, stale Jul 8, 2022
Documentation backport automation moved this from To do to Done Jul 8, 2022
@ghost ghost locked as resolved and limited conversation to collaborators Aug 7, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
area-System.Linq documentation Documentation bug or enhancement, does not impact product or test code
Projects
No open projects
Development

No branches or pull requests

3 participants