-Here's how to build the HTML pages locally so you can preview your
-updates before you commit and push.
+Here's how to build the HTML pages locally so you can preview your updates before you commit and push.
+
+Additional information is available on the "'Documentation' page on the Arvados wiki":https://dev.arvados.org/projects/arvados/wiki/Documentation.
+
+h2. Install dependencies
+
+<pre>
+arvados/doc$ sudo apt-get install build-essential libcurl4-openssl-dev libgnutls28-dev libssl-dev
+arvados/doc$ bundle install
+</pre>
+
+To generate the Python SDK documentation, these additional dependencies are needed:
+
+<pre>
+arvados/doc$ sudo apt-get install python3-pip
+arvados/doc$ pip3 install arvados-python-client
+arvados/doc$ pip3 install pdoc3
+</pre>
+
+h2. Generate HTML pages
+
+<pre>
+arvados/doc$ bundle exec rake
+</pre>
+
+Alternately, to make the documentation browsable on the local filesystem: