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

API documentation debt - Microsoft.Extensions.Primitives #43920

Closed
Tracked by #43849
carlossanlop opened this issue Oct 27, 2020 · 2 comments
Closed
Tracked by #43849

API documentation debt - Microsoft.Extensions.Primitives #43920

carlossanlop opened this issue Oct 27, 2020 · 2 comments
Labels
area-Extensions-Primitives documentation Documentation bug or enhancement, does not impact product or test code
Milestone

Comments

@carlossanlop
Copy link
Member

Area owners: @maryamariyan @eerhardt

The APIs in the list below are missing some or all of their documentation. Please add the missing documentation directly in triple slash comments in source. We will make sure it gets ported to dotnet-api-docs after it's merged.

Make sure to follow the documentation guidelines defined in the dotnet-api-docs wiki:
https://github.com/dotnet/dotnet-api-docs/wiki

Also please add me as a PR reviewer.

Community contributions are welcome.

Microsoft.Extensions.Primitives
DocId Summary Parameters TypeParameters ReturnValue Source File Path Docs URL
Microsoft.Extensions.Primitives namespace Missing NA NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/ns-Microsoft.Extensions.Primitives.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives?branch=master
M:Microsoft.Extensions.Primitives.ChangeToken.OnChange
(System.Func{Microsoft.Extensions.Primitives.IChangeToken},System.Action)
Present Present NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/ChangeToken.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.ChangeToken.OnChange?branch=master
M:Microsoft.Extensions.Primitives.ChangeToken.OnChange``1
(System.Func{Microsoft.Extensions.Primitives.IChangeToken},System.Action{``0},``0)
Present Present Present Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/ChangeToken.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.ChangeToken.OnChange?branch=master
T:Microsoft.Extensions.Primitives.Extensions Missing NA NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/Extensions.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.Extensions?branch=master
M:Microsoft.Extensions.Primitives.InplaceStringBuilder.#ctor(System.Int32) Missing Missing NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/InplaceStringBuilder.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.InplaceStringBuilder.-ctor?branch=master
M:Microsoft.Extensions.Primitives.InplaceStringBuilder.Append
(Microsoft.Extensions.Primitives.StringSegment)
Missing Missing NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/InplaceStringBuilder.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.InplaceStringBuilder.Append?branch=master
M:Microsoft.Extensions.Primitives.InplaceStringBuilder.Append(System.Char) Missing Missing NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/InplaceStringBuilder.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.InplaceStringBuilder.Append?branch=master
M:Microsoft.Extensions.Primitives.InplaceStringBuilder.Append(System.String) Missing Missing NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/InplaceStringBuilder.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.InplaceStringBuilder.Append?branch=master
M:Microsoft.Extensions.Primitives.InplaceStringBuilder.Append
(System.String,System.Int32,System.Int32)
Missing Missing NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/InplaceStringBuilder.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.InplaceStringBuilder.Append?branch=master
P:Microsoft.Extensions.Primitives.InplaceStringBuilder.Capacity Missing NA NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/InplaceStringBuilder.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.InplaceStringBuilder.Capacity?branch=master
T:Microsoft.Extensions.Primitives.InplaceStringBuilder Missing NA NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/InplaceStringBuilder.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.InplaceStringBuilder?branch=master
M:Microsoft.Extensions.Primitives.InplaceStringBuilder.ToString Missing NA NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/InplaceStringBuilder.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.InplaceStringBuilder.ToString?branch=master
M:Microsoft.Extensions.Primitives.StringSegment.Equals(System.Object) Missing Missing NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringSegment.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringSegment.Equals?branch=master
M:Microsoft.Extensions.Primitives.StringSegment.GetHashCode Missing NA NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringSegment.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringSegment.GetHashCode?branch=master
M:Microsoft.Extensions.Primitives.StringSegment.IsNullOrEmpty
(Microsoft.Extensions.Primitives.StringSegment)
Present Present NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringSegment.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringSegment.IsNullOrEmpty?branch=master
M:Microsoft.Extensions.Primitives.StringSegment.op_Implicit
(Microsoft.Extensions.Primitives.StringSegment)~System.ReadOnlyMemory{System.Char}
Present Present NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringSegment.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringSegment.op_Implicit?branch=master
M:Microsoft.Extensions.Primitives.StringSegment.op_Implicit
(Microsoft.Extensions.Primitives.StringSegment)~System.ReadOnlySpan{System.Char}
Present Present NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringSegment.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringSegment.op_Implicit?branch=master
M:Microsoft.Extensions.Primitives.StringSegment.op_Implicit
(System.String)~Microsoft.Extensions.Primitives.StringSegment
Present Present NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringSegment.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringSegment.op_Implicit?branch=master
P:Microsoft.Extensions.Primitives.StringSegmentComparer.Ordinal Missing NA NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringSegmentComparer.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringSegmentComparer.Ordinal?branch=master
P:Microsoft.Extensions.Primitives.StringSegmentComparer.OrdinalIgnoreCase Missing NA NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringSegmentComparer.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringSegmentComparer.OrdinalIgnoreCase?branch=master
T:Microsoft.Extensions.Primitives.StringSegmentComparer Missing NA NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringSegmentComparer.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringSegmentComparer?branch=master
M:Microsoft.Extensions.Primitives.StringTokenizer.GetEnumerator Missing NA NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringTokenizer.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringTokenizer.GetEnumerator?branch=master
M:Microsoft.Extensions.Primitives.StringTokenizer.Enumerator.#ctor
(Microsoft.Extensions.Primitives.StringTokenizer@)
Missing Missing NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringTokenizer+Enumerator.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringTokenizer.Enumerator.-ctor?branch=master
T:Microsoft.Extensions.Primitives.StringTokenizer.Enumerator Missing NA NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringTokenizer+Enumerator.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringTokenizer.Enumerator?branch=master
M:Microsoft.Extensions.Primitives.StringValues.GetHashCode Missing NA NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringValues.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringValues.GetHashCode?branch=master
M:Microsoft.Extensions.Primitives.StringValues.op_Equality
(Microsoft.Extensions.Primitives.StringValues,System.String)
Missing Missing NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringValues.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringValues.op_Equality?branch=master
M:Microsoft.Extensions.Primitives.StringValues.op_Equality
(Microsoft.Extensions.Primitives.StringValues,System.String[])
Missing Missing NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringValues.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringValues.op_Equality?branch=master
M:Microsoft.Extensions.Primitives.StringValues.op_Equality
(System.String,Microsoft.Extensions.Primitives.StringValues)
Missing Missing NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringValues.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringValues.op_Equality?branch=master
M:Microsoft.Extensions.Primitives.StringValues.op_Equality
(System.String[],Microsoft.Extensions.Primitives.StringValues)
Missing Missing NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringValues.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringValues.op_Equality?branch=master
M:Microsoft.Extensions.Primitives.StringValues.op_Implicit
(Microsoft.Extensions.Primitives.StringValues)~System.String[]
Present Present NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringValues.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringValues.op_Implicit?branch=master
M:Microsoft.Extensions.Primitives.StringValues.op_Implicit
(System.String)~Microsoft.Extensions.Primitives.StringValues
Present Present NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringValues.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringValues.op_Implicit?branch=master
M:Microsoft.Extensions.Primitives.StringValues.op_Implicit
(System.String[])~Microsoft.Extensions.Primitives.StringValues
Present Present NA Missing https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringValues.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringValues.op_Implicit?branch=master
M:Microsoft.Extensions.Primitives.StringValues.Enumerator.#ctor
(Microsoft.Extensions.Primitives.StringValues@)
Missing Missing NA NA https://github.com/dotnet/dotnet-api-docs/blob/master/xml/Microsoft.Extensions.Primitives/StringValues+Enumerator.xml https://review.docs.microsoft.com/en-us/dotnet/api/Microsoft.Extensions.Primitives.StringValues.Enumerator.-ctor?branch=master

Notes:

  • The namespaces need to be documented directly in dotnet-api-docs.
  • Some of the APIs are obsolete, so I'll let area owners decide if they want to still document them or skip them. If you opt for documenting them, please do it directly in dotnet-api-docs.
@carlossanlop carlossanlop added documentation Documentation bug or enhancement, does not impact product or test code help wanted [up-for-grabs] Good issue for external contributors untriaged New issue has not been triaged by the area owner area-Microsoft.Extensions labels Oct 27, 2020
@carlossanlop carlossanlop added this to the 6.0.0 milestone Oct 27, 2020
@maryamariyan maryamariyan added area-Extensions-Primitives and removed area-Microsoft.Extensions untriaged New issue has not been triaged by the area owner labels Nov 5, 2020
@ghost
Copy link

ghost commented Nov 5, 2020

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

@maryamariyan maryamariyan modified the milestones: 6.0.0, 7.0.0 Jul 19, 2021
@maryamariyan maryamariyan removed the help wanted [up-for-grabs] Good issue for external contributors label Dec 22, 2021
@tarekgh tarekgh modified the milestones: 7.0.0, Future Aug 10, 2022
@Nick-Stanton
Copy link
Member

Above PRs resolve this issue

@ghost ghost locked as resolved and limited conversation to collaborators Oct 26, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
area-Extensions-Primitives documentation Documentation bug or enhancement, does not impact product or test code
Projects
None yet
Development

No branches or pull requests

4 participants