more documentation improvements

[synfinatic]

Refs: #213

[codecov]

Codecov Report

Merging #237 (c74553e) into main (41f1a99) will not change coverage.
The diff coverage is n/a.

❗ Current head c74553e differs from pull request most recent head 4cb5177. Consider uploading reports for the commit 4cb5177 to get more accurate results

@@           Coverage Diff           @@
##             main     #237   +/-   ##
=======================================
  Coverage   43.47%   43.47%           
=======================================
  Files          11       11           
  Lines        1702     1702           
=======================================
  Hits          740      740           
  Misses        898      898           
  Partials       64       64           

---

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 41f1a99...4cb5177. Read the comment docs.