docs

docs copied to clipboard

We're already doing this via the developer docs; good approach to consistency.

To do: Identify syntax needed for both RST and MD.

In addition, revisit all external link syntax to ensure trailing underlines are specified correctly as per Sphinx requirements:

• single trailing underline _: reference is named and the same target URI may be referred to elsewhere site-wide.
• double training underline __: reference and target are both anonymous, can't refer to the target elsewhere site-wide

Better to default to single training underline to avoid warning.log error: WARNING: Duplicate target name, cannot be used as a unique reference: "thing".