Port Microsoft.Extensions.Primitives new docs

[directhex]

@dotnet/area-extensions-primitives @carlossanlop @gewarren PTAL

There's some line-ending mess in this file, I think the committed file is a mix of LF and CRLF so my touching it screws up as git normalizes the whole file one way or the other

[ghost]

I couldn't figure out the best area label to add to this PR. If you have write-permissions please help me learn by adding exactly one area label.

[ghost]

I couldn't figure out the best area label to add to this PR. If you have write-permissions please help me learn by adding exactly one area label.

[learn-build-service-prod]

Learn Build status updates of commit 14e142b:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/Microsoft.Extensions.Primitives/StringValues.xml	✅Succeeded	View

For more details, please refer to the build report.

For any questions, please:

• Try searching the learn.microsoft.com contributor guides
• Post your question in the Learn support channel

[gewarren]

xrefs are weird though.

[dotnet-policy-service]

Tagging subscribers to this area: @dotnet/area-extensions-primitives

[directhex]

xrefs are weird though.

Should I be fixing that up manually? It looks OK in the source .cs

[gewarren]

xrefs are weird though.

Should I be fixing that up manually? It looks OK in the source .cs

I'm not sure why the porting tool does this sometimes. It would be great if you can fix them manually.

[carlossanlop]

Should I be fixing that up manually? It looks OK in the source .cs

@directhex you're seeing xrefs inside markdown remarks. Those are valid. No need to convert them.

If you were seeing xrefs outside of markdown, the build would've failed. But that's not the case.

Ideally, area owners should be adding remarks as plain xml elements to their triple slash comments, but if they were added as markdown to triple slash, the tool transfers them in that format.

[carlossanlop]

Left the suggested changes for the weird xrefs.
I wonder why the buld didn't fail. I guess they were formatted as valid xml, even though the elements themselves are not the correct ones.

[learn-build-service-prod]

Learn Build status updates of commit 006d159:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/Microsoft.Extensions.Primitives/StringValues.xml	✅Succeeded	View

For more details, please refer to the build report.

For any questions, please:

• Try searching the learn.microsoft.com contributor guides
• Post your question in the Learn support channel

[learn-build-service-prod]

Learn Build status updates of commit f70db18:

✅ Validation status: passed

File	Status	Preview URL	Details
xml/Microsoft.Extensions.Primitives/StringValues.xml	✅Succeeded	View

For more details, please refer to the build report.

For any questions, please:

• Try searching the learn.microsoft.com contributor guides
• Post your question in the Learn support channel