From 7f7e3d98595921e0d772aeda068896fec99a92cd Mon Sep 17 00:00:00 2001
From: P. J. McDermott <pehjota>
Date: Sun, 28 Oct 2012 16:29:06 -0400
Subject: Publicly document the specs build process.

---
(limited to 'dev')

diff --git a/dev/specs.mdwn b/dev/specs.mdwn
new file mode 100644
index 0000000..a632889
--- /dev/null
+++ b/dev/specs.mdwn
@@ -0,0 +1,31 @@
+[[!meta title="Specifications"]]
+
+Specifications for the distribution are maintained in the
+[doc/specs.git][specs-git] repository and published in HTML format on the
+[specs Web site][specs-www].
+
+
+Building Locally
+================
+
+Newer specifications like SPF 2.0 are multi-chapter books rendered from Markdown
+source files using the custom-developed "markdownbook" software.  markdownbook
+is currently used as a submodule of the specs repository.
+
+One can download and build a local copy of the specifications from the
+repository using the following commands:
+
+    $ git clone git://git.os.libiquity.com/doc/specs.git
+    $ cd specs
+    $ git submodule init
+    $ git submodule update
+    $ make
+
+This will render HTML versions of the specifications in the source tree.  You
+can view these in a Web browser, e.g.:
+
+    $ x-www-browser specs/spf-2.0/index.html
+
+
+[specs-git]: http://git.os.libiquity.com/doc/specs.git
+[specs-www]: http://specs.os.libiquity.com/
--
cgit v0.9.1