Make System.Formats.Asn1 triple slash documentation the source of truth

[vcsjones]

The pull request makes the triple slash documentation for System.Formats.Asn1 the source of truth for documentation.

1. Use the PortToTripleSlash tool to update the C# documentation with the latest documentation from dotnet-api-docs.

   This made substantial changes that were largely formatting, which I reverted. I kept the changes to two things: actual content changes (text changes, missing documentation, etc) and re-ordering XML elements as appropriate (param elements not matching parameter order, putting remarks at the end)

2. Remove <UseCompilerGeneratedDocXmlFile>false</UseCompilerGeneratedDocXmlFile>. The default value for this is true. I can't remember where, but I recall that our preference is to just remove it entirely, not explicitly set it to true.

[dotnet-policy-service]

Tagging subscribers to this area: @dotnet/area-system-formats-asn1, @bartonjs, @vcsjones
See info in area-owners.md if you want to be subscribed.

[vcsjones]

cc @carlossanlop in case I missed anything.

[gewarren]

Thanks for doing this!

[gewarren]

These might need <para> tags so they remain on separate lines in the docs, right @carlossanlop?

[gewarren]

I see now that that would mean a lot of changes throughout this PR. I'm also fine with not adding them.

[vcsjones]

The porttotripleslash tool did not put <para> there, so I assumed it was not required.

[carlossanlop]

LGTM (modulo @gewarren's suggestions). Can you please backport it to release/9.0 when you're done?

[gewarren]

@carlossanlop Is there a documented set of steps needed to set this repo as the source of truth? If so, can you add a step to disallow edits in the dotnet-api-docs repo for the affected namespace? Like this.

[ViktorHofer]

The default value for this is true. I can't remember where, but I recall that our preference is to just remove it entirely, not explicitly set it to true.

Correct 👍 and big thanks for doing this.

[vcsjones]

/backport to release/9.0

[github-actions]

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