@@ -46,6 +46,39 @@ And now your docs are live! View them at:
4646 instead for live-network ships. You can also replace `localhost` with the IP
4747 of your instance, if you're running your urbit in the cloud.
4848
49+## Building the docs with |static
50+
51+**note** This instructions are for use with the the [release-candidate branch](https://github.com/urbit/arvo/tree/release-candidate)
52+of Arvo.
53+
54+Arvo comes with a built-in static site generator, which is very useful for
55+exporting sites and pages built with udon, sail, html, markdown or some
56+combination of these. Combinations like these docs that you're reading!
57+
58+In order to build the docs into a static site, do the following.
59+
60+Make sure that you've mounted your ship to your filesystem, but running the following
61+in your Dojo.
62+
63+> ~ship:dojo>|mount /===
64+
65+Then, copy these docs into the pier of a booted ship. It is very important that
66+copy the docs into the exact directory indicated in your pier.
67+
68+> $ cp -r . <ship-name>/home/web/static-site
69+
70+Now, run the static site generator on your urbit ship.
71+
72+> ~ship:dojo>|static
73+
74+You can now navigate to the output director and run a webserver to view your built docs.
75+
76+> $ cd <ship-name>/.urb/put/web/static-site
77+> $ python -m SimpleHTTPServer
78+
79+Visit `localhost:8000` to see the built docs. Rerun `|static` to build docs and
80+see changes.
81+
4982## Learn a lot, and have fun!
5083
5184People are always around on