Merge pull request #291 from stan-dev/feature/222-doc-fixes

Feature/222 doc fixes

Author: mitzimorris

README.md

@@ -23,7 +23,7 @@ to compile and run a Stan program.
 
 ### Docs
 
-See https://cmdstanpy.readthedocs.io/en/latest/index.html
+See https://cmdstanpy.readthedocs.io/
 
 ### Source Repository
 

docsrc/Makefile

@@ -0,0 +1,29 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = CmdStanPy
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@echo 'Build CmdStanPy docs:'
+	@echo '    target github:  build HTML pages and copy to docs dir'
+	@echo ''
+	@echo 'Sphinx version, targets:'
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+github:
+	@make html
+	@cp -a _build/html/. ../docs
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+