improve doc comments for FSharp.Core

[dsyme]

Continues the work of #9837 in a feature branch

There is an F# community effort going on to properly generate the FSharp.Core API docs using the fsdocs tooling, see

• https://github.com/fsharp/fsharp-core-api-docs
• https://fsharp.github.io/fsharp-core-api-docs/reference/FSharp.Core/index.html

As part of this we will need to cleanup our XML doc in the original FSharp.Core source.

This PR will contain a bunch of improvements in this regard. I propose that doc improvements get pushed into feature/docs and we integrate them from time to time. Then for now the community docs for FSharp.Core can be built from fsharp/docs.

This batch of work includes:

1. Add spacing between summary, param, exception, returns and remarks sections so it's much easier to visuall see what's what in the documentation. (currently it is hard to review and read in the source itself because it is cramped)

2. Use <see cref="..."> more systematically - we already use this in seq.fsi so there is nothing new here, but this correctly adds the T: , P: and M: tags to the references.

3. Remove a massive remarks section for the Printf module which is really written documentation, and has been transferred into the F# docs here: F# plaintext printing documentation docs#19632

See also #9805 which deals with possible improvements to the docs story where the compiler checks the docs including symbol references.

[dsyme]

@KevinRansom KevinRansom deleted the feature/docs branch 3 hours ago

Please leave this branch in existence, thanks (or we can give it another name). The CI for the repo https://github.com/fsharp/fsharp-core-api-docs will initially be set up to build directly from this branch. Once the docs are of high quality we will set it up to build multiple versions of the docs from a version tag.

I will set up auto-merge from master to feature/docs