README.md: Add information on docs

Add a link to the auto-generated github pages documentation and add
instructions for how to build them using Sphinx and some references
on reStructuredText.

Signed-off-by: Oliver O'Halloran <oohall@gmail.com>

1 files changed, 26 insertions, 0 deletions

diff --git a/README.md b/README.md
index c6cdae5..e8743a9 100644
--- a/README.md
+++ b/README.md
@@ -12,6 +12,8 @@ Archives: https://lists.ozlabs.org/pipermail/skiboot/
 
 Patchwork: http://patchwork.ozlabs.org/project/skiboot/list/
 
+Documentation: http://open-power.github.io/skiboot/doc/index.html
+
 ## Overview
 OPAL firmware (OpenPower Abstraction Layer) comes in several parts.
 
@@ -79,6 +81,30 @@ from here: https://www.kernel.org/pub/tools/crosstool/ When using
 these compilers add /opt/cross/gcc-4.8.0-nolibc/powerpc64-linux/bin/
 to your PATH. Once this is done skiboot can be compiler by just running `make`
 
+### Building Documentation
+
+We use [Sphinx](http://www.sphinx-doc.org/) to produce various documentation
+from reStructuredText (preferred) and Markdown. The Sphinx documentation has
+a useful primer for  reStructuredText
+[here](http://www.sphinx-doc.org/en/master/usage/restructuredtext/index.html).
+And the docutils website has a nice [quick
+reference](http://docutils.sourceforge.net/docs/user/rst/quickref.html) for the
+basic constructes.
+
+Building on Fedora
+```
+dnf install python3-sphinx python3-recommonmark.noarch
+pip install -r doc/requirements.txt
+make -C doc/ html SPHINXBUILD=sphinx-build-3
+```
+
+On Ubuntu:
+```
+Patches welcome!
+```
+
+View the output using `doc/_build/html/index.html`
+
 ## Testing
 Skiboot comes with a set of unit tests that can be run on your desktop.
 They can can be run with: