Merge pull request #8155 from Carreau/doc-doc

more docs on building docs

docs/Makefile

@@ -28,6 +28,7 b' help:'
 	@echo "  info        Texinfo files and run them through makeinfo"
 	@echo "  changes     an overview over all changed/added/deprecated items"
 	@echo "  linkcheck   check all external links for integrity (takes a long time)"
+	@echo "  gh-pages    clone IPython docs in ./gh-pages/ , build doc, autocommit"
 	@echo
 	@echo "Compound utility targets:"
 	@echo "pdf          latex and then runs the PDF generation"

docs/README.rst

@@ -3,6 +3,14 b' IPython Documentation'
 
 This directory contains the majority of the documentation for IPython. 
 
+Deploy docs
+-----------
+
+Run ``make gh-pages``, and follow instruction, that is to say:
+cd into ``gh-pages``, check that everything is alright and push.
+
+
+
 Requirements
 ------------
 The following tools are needed to build the documentation: