The Stan documentation consists of:
- Stan Reference Manual
- Stan Functions Reference
- Stan book (formerly known as “Stan Users Manual”)
CmdStan has its own users manual. The cmdstan makefile builds the Stan ref-manual and functions reference and copies them to the cmdstan docs dir as part of its docset.
The Stan documentation set has been converted from latex to Rmarkdown. The toolchain to build the docs requires: latex, pandoc, pandoc-citeproc, and the R bookdown package. The cmdstan documentation is still in latex and needs to be converted to Rmarkdown.
If there were a single repo for just the docs, then we could use github’s project pages to serve the html version of the current docs. We could also distribute pdfs of the documentation set for all previous releases.
We can either move all documentation into the existing
stan-book repo or create a new repo
stan-docs (or whatever).
what do yinz think?