Undocumented 7.0 APIs in System.ComponentModel

[carlossanlop]

@dotnet/area-system-componentmodel

Below is the list of APIs that were introduced in 7.0 and have not yet been fully documented.

Relevant dates:

The last day to merge API documentation directly into triple slash comments in dotnet/runtime is before the RC1 snap on August 15th.
After the RC1 snap, all pending documentation changes need to be merged directly into dotnet-api-docs, and the last day to do so is before the RC2 snap on September 13th.

Undocumented System.ComponentModel APIs as of Preview6

Summary	Parameters	TypeParameters	ReturnValue	API
Present	Missing	NA	Present	M:System.ComponentModel.DateOnlyConverter.ConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object,System.Type)
Missing	NA	NA	NA	M:System.ComponentModel.HalfConverter.#ctor
Missing	NA	NA	NA	M:System.ComponentModel.Int128Converter.#ctor
Present	Missing	NA	Present	M:System.ComponentModel.TimeOnlyConverter.ConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object,System.Type)
Missing	NA	NA	NA	M:System.ComponentModel.UInt128Converter.#ctor

[ghost]

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

Issue Details

---

@dotnet/area-system-componentmodel

Below is the list of APIs that were introduced in 7.0 and have not yet been fully documented.

Relevant dates:

The last day to merge API documentation directly into triple slash comments in dotnet/runtime is before the RC1 snap on August 15th.
After the RC1 snap, all pending documentation changes need to be merged directly into dotnet-api-docs, and the last day to do so is before the RC2 snap on September 13th.

Undocumented System.ComponentModel APIs as of Preview6

Summary	Parameters	TypeParameters	ReturnValue	API
Present	Missing	NA	Present	M:System.ComponentModel.DateOnlyConverter.ConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object,System.Type)
Missing	NA	NA	NA	M:System.ComponentModel.HalfConverter.#ctor
Missing	NA	NA	NA	M:System.ComponentModel.Int128Converter.#ctor
Present	Missing	NA	Present	M:System.ComponentModel.TimeOnlyConverter.ConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object,System.Type)
Missing	NA	NA	NA	M:System.ComponentModel.UInt128Converter.#ctor

Author:	carlossanlop
Assignees:	-
Labels:	documentation, area-System.ComponentModel
Milestone:	7.0.0

[tarekgh]

@carlossanlop this is again issue with the tool that doesn't handle the /// <inheritdoc /> tag from the sources.

[tarekgh]

@carlossanlop I confirmed

M:System.ComponentModel.DateOnlyConverter.ConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object,System.Type)
M:System.ComponentModel.TimeOnlyConverter.ConvertTo(System.ComponentModel.ITypeDescriptorContext,System.Globalization.CultureInfo,System.Object,System.Type)

already have inheritdoc when you fix the tool, this should be handled automatically.

For the following items:

M:System.ComponentModel.HalfConverter.#ctor
M:System.ComponentModel.Int128Converter.#ctor
M:System.ComponentModel.UInt128Converter.#ctor

The sources don't have an explicit constructor. I believe this should be handled through the tool too.

By that, I think no action needed from ourside.

[ghost]

This issue has been marked needs-author-action and may be missing some important information.

[carlossanlop]

Acknowledged. I'll close it. If I see any other APIs, I'll open a new issue.

[ericstj]

Looks like the tool has a bug where it doesn't port docs for the implicit parameterless constructor. We might need to manually doc these to get it in for 7.0.

[tarekgh]

reopen to handle the parameterless constructor cases.

[carlossanlop]

Issue opened to fix the parameterless constructor case in the porting tool in the future: dotnet/api-docs-sync#132