...

Equation numbering (and references to equations) will only work within a file.

Figures

When you start adding figures to your documentation, keep in mind that binary files can lead to repo size bloat IF they change a lot so don’t add a figure until you are confident its the final version.

Figures should be png format and under 500 pixels on the longest side.

Keep figures in a docs/assets/figures subdirectory.