Notes for authors

7. Notes for authors#

See https://jupyterbook.org/en/stable/content/myst.html
Move to MyST Markdown notation {ref}, {eq}, and so on as appropriate.
References to other sections and subsections within them work best using enhanced mark-down style [text](label), with the second entry being a myST label. For example: section Error bounds for linear algebra etc., subsection Matrix norms.
To number equations for referencing, use MyST-Markdown-augmented $$...$$ notation, as with $$2+2=4$$ (eq-obvious)
If the top-level section atop a file is labelled as with “(section-label)=” then either the {ref}section-label-in-back-quotes syntax or “enhanced markdown” syntax [text](section-label)can be used instead of {doc}file-base-name-in-back-quotes This avoids the need to keep track of which folder a file is in, and is useful when there are variant files distinguished by suffixes like “-python”/”-julia” but one wants to use the same cross-reference label.
- For example, Runge-Kutta Methods or Runge-Kutta Methods vs Runge-Kutta Methods.
When using <br>, it should appear on its own line, not at end-of-line. (For PDF output; HTML output is more forgiving.) This is relevant to some pseudo-code appearence in the PDF; e.g in Euler’s Method