* Add instructions on setting up zap for ARM linux

* Fix typo

* Restyle

* Make links real links

* Restyle

* Add full traceback flag for sphinx to debug doc build issues

* Fix the flag location

* Add icon_links to options ... not sure why they are required, but at least build should not fail

* Disable turn-warnings-to-errors in the doc build

* Fix several readme.md cross reference links with new new myst

* More selectively suppress warnings. Still not ideal as the wrong reference is probably the most useful warning by far

* Restyle

* Remove extra comment

* Fix final errors: remove some bracketing, add top level as an external link prefix