HT4 formal documentation

[jbqubit]

Formal hardware documentation for Sayma v2 is to be maintained in github.

• Use the software tool Sphinx.
• Setup automatic rendering on readthedocs.org with webhook to git pushes.
• Embed link in github.com that links to readthedocs.org.
• scope: Expected content is superset of existing Sayma v1.0 documentation

[jbqubit]

@marmeladapk Who is working on the Sayma v2 documentation? This is an excellent deliverable for COVID-at-home. :)

Getting good documentation is now critical as Oxford @hartytp begins testing of the hardware. Right testing focuses on phase noise. @hartytp took some notes on the clock synchronization scheme while bootstrapping his test setup. Having authoritative documentation framework is key to get physicists up and running with minimal fuss -- eg DIP switch configuration on AMC -- and so that there's a structure to absorb refinements or extensions to documentation that come from testing in various labs.

[marmeladapk]

@jbqubit Right now mainly I am working on it. I ported existing AMC and RTM documentation to sphinx already, however it's still a lot of work to update it to v2.0. I'll post here once I'll have something usable.