docs clarifications

[petrelharp]

Closes #1813 (I hope).

[petrelharp]

Darn it, I need to figure out how to update all my pre-commit stuff...

[petrelharp]

Ah, ok, that was painless actually. Let's see - here's my updated documentation:

and

[codecov]

Codecov Report

Merging #1814 (3a92cb3) into main (9f25482) will not change coverage.
The diff coverage is n/a.

❗ Current head 3a92cb3 differs from pull request most recent head c0c1da3. Consider uploading reports for the commit c0c1da3 to get more accurate results

@@           Coverage Diff           @@
##             main    #1814   +/-   ##
=======================================
  Coverage   93.41%   93.41%           
=======================================
  Files          27       27           
  Lines       24756    24756           
  Branches     1095     1095           
=======================================
  Hits        23127    23127           
  Misses       1594     1594           
  Partials       35       35           

Flag	Coverage Δ
c-tests	92.16% <ø> (ø)
lwt-tests	89.14% <ø> (ø)
python-c-tests	94.55% <ø> (ø)
python-tests	98.75% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
python/tskit/trees.py	97.83% <ø> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 9f25482...c0c1da3. Read the comment docs.

[jeromekelleher]

LGTM. Some icing would be to put in doi http links for the papers, but I suspect a lot of them won't have dois.