Following up on Plan for Planning:
I’m now just about ready to begin handing over documents to authors.
I’ve used LDM-152 as a prototype. You can see the
- repository at https://github.com/lsst/LDM-152/tree/tickets/DM-3814
- continuously deployed website at http://ldm-152.readthedocs.org
The visual design is forked from the default readthedocs.org Sphinx theme and was gently tweaked to suit singe-page documents like ours. I can do some additional modification to colours, fonts, etc. to better suit our needs. More dramatic re-designing will probably require implementing our own theme from scratch. But this should definitely be sufficient for developing the design documents.
I’m thinking it may be good to put together some docs early next week to specify the relevant bits of reST syntax and other information needed to work with the Design Documents.
Now that I have the templates, content conversion and build process mostly developed for Word→reST design documents, I may have time next week to even roll out continuous web deployment of LaTeX-based design documents. I think I can use Travis CI, GitHub pages and tex4ht to quickly get something together.