Update documentation

[Nashtare]

Description

Updates the documentation throughout the lib:

• rearrange display for better reader convenience
• fix typos
• unify wording of serialization (british vs american)

PR Checklist:

• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• I have added or updated tests that comprehensively prove my change is effective or that my feature works

[codecov]

Codecov Report

All modified lines are covered by tests ✅

Comparison is base (7553d9a) 82.68% compared to head (c9de4b2) 82.50%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main       #7      +/-   ##
==========================================
- Coverage   82.68%   82.50%   -0.19%     
==========================================
  Files          13       13              
  Lines        1057     1023      -34     
==========================================
- Hits          874      844      -30     
+ Misses        183      179       -4     

Files	Coverage Δ
src/dkg/key_generation.rs	91.11% <ø> (-0.31%)	⬇️
src/error.rs	0.00% <ø> (ø)
src/lib.rs	100.00% <ø> (ø)
src/parameters.rs	100.00% <ø> (ø)
src/sign/precomputation.rs	90.14% <ø> (-0.40%)	⬇️

... and 3 files with indirect coverage changes

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[dvdplm]

It would be fantastic to have some of the example code be actual doctests butperhaps not in this PR.

[Nashtare]

@dvdplm we do have actual doctests already (though more may be better)