702.document snapshots

[meejah]

Fixes #702

[codecov]

Codecov Report

Merging #710 (5e6883f) into main (a68f9c7) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main     #710   +/-   ##
=======================================
  Coverage   91.79%   91.79%           
=======================================
  Files          38       38           
  Lines        5144     5144           
  Branches      640      640           
=======================================
  Hits         4722     4722           
  Misses        277      277           
  Partials      145      145           

Flag	Coverage Δ
integration	72.97% <ø> (ø)

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

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[meejah]

Note to self: the metadata entries in the Collective and Personal should be @metadata instead (e.g. in all the diagrams).

[meejah]

Besides the above tweak needed for the diagrams, I think this is ready for some Opinions if you have any @exarkun (you can see a rendered version of this branch by clicking through the "read the docs" check).

[meejah]

I tried ensuring all the SVGs are "plain" (not "Inkscape") SVGs but github / firefox is still rendering the arrows w/o heads.

That's the only gnit though; I'm going to merge this -- please file followup tickets if anything is missing or unclear :)

[hacklschorsch]

Is this on purpose? 30pt ~= 10,6 mm.

ReadTheDocs seems to only interpret the width (of 100%), the GitHub rendering only interprets the height (30pt, tiny).
Both keep the original aspect ratio - which is good - probably because one of width/height is a percentage?

[hacklschorsch]

(On my end, a height of 300pt looks good in GitHub)

[meejah]

#730