Placeholders for documentation

[dsyme]

@gbaydin This adds about 500 placeholders for documentation. Not pretty but necesssary. Seems best to add them first and then fill things in as it makes the codebase still look consistent

I add <summary>...</summary> tags everywhere. This is because I'd eventually expect most docs in this repo to use math \(...\) and \[...\]

Let me know what you think

BTW

• I worked on tooling to make F# IDE tools check docs as you type - it makes it so much easier to reliably write the docs Check XML doc parameter names for FSharp.Core via opt-in checking dotnet/fsharp#10118. That will appear in upcoming editions of Visual Studio and F# support in VS Code

• I worked on making sure we can add examples too e.g. https://github.com/DiffSharp/DiffSharp/pull/184/files#diff-4db1087bc965bcae8b149b068e5b186cR14

[codecov]

Codecov Report

Merging #184 into dev will not change coverage.
The diff coverage is 0.00%.

@@           Coverage Diff           @@
##              dev     #184   +/-   ##
=======================================
  Coverage   67.04%   67.04%           
=======================================
  Files          13       13           
  Lines        4797     4797           
  Branches     1186     1187    +1     
=======================================
  Hits         3216     3216           
  Misses        924      924           
  Partials      657      657           

Impacted Files	Coverage Δ
src/DiffSharp.Core/DiffSharp.fs	36.34% <0.00%> (ø)
src/DiffSharp.Core/Distributions.fs	67.90% <ø> (ø)
src/DiffSharp.Core/Model.fs	62.45% <ø> (ø)
src/DiffSharp.Core/Optim.fs	82.83% <ø> (ø)
src/DiffSharp.Core/Tensor.fs	71.31% <ø> (ø)

[dsyme]

Note: failure is just codecov/patch, we can ignore that

@gbaydin Are you ok with us merging this? Best to get it in to avoid conflicts

[dsyme]

@gbaydin I'll pull this now

[gbaydin]

@dsyme thanks, I think it's OK and it was a good time to merge it.

I add

...

tags everywhere. This is because I'd eventually expect most docs in this repo to use math (...) and [...]

This makes sense.

I worked on tooling to make F# IDE tools check docs as you type - it makes it so much easier to reliably write the docs dotnet/fsharp#10118. That will appear in upcoming editions of Visual Studio and F# support in VS Code

Looking forward to using it. Exciting improvements with documentation tools.

I worked on making sure we can add examples too e.g. https://github.com/DiffSharp/DiffSharp/pull/184/files#diff-4db1087bc965bcae8b149b068e5b186cR14

Minor: I couldn't see the example there. Am I missing something?