[Skiboot] [PATCH] README.md: Add information on docs

Oliver O'Halloran oohall at gmail.com
Mon Dec 9 13:04:51 AEDT 2019

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 at gmail.com>
 .travis.yml |  2 +-
 README.md   | 26 ++++++++++++++++++++++++++
 2 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 6ddf485d7c83..8080889dd399 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -47,7 +47,7 @@ addons:
       name: "open-power/skiboot"
       description: "Build submitted via Travis CI"
-    notification_email: stewart at linux.vnet.ibm.com
+    notification_email: oohall at gmail.com
     branch_pattern: coverity_scan
diff --git a/README.md b/README.md
index c6cdae5cd255..e8743a9ef022 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
+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:

More information about the Skiboot mailing list