diff --git a/versioning.html b/versioning.html
new file mode 100644
index 0000000..07f22f0
--- /dev/null
+++ b/versioning.html
@@ -0,0 +1,140 @@
+
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+    <title>Version Scheme &#8212; OpenPOWER Firmware v2.6-257-g5b5624c2
+ documentation</title>
+    <link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
+    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
+    <script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
+    <script type="text/javascript" src="_static/jquery.js"></script>
+    <script type="text/javascript" src="_static/underscore.js"></script>
+    <script type="text/javascript" src="_static/doctools.js"></script>
+    <link rel="index" title="Index" href="genindex.html" />
+    <link rel="search" title="Search" href="search.html" />
+    <link rel="next" title="op-build Release Notes" href="release-notes/index.html" />
+    <link rel="prev" title="Supported Boot Devices" href="boot-devices.html" />
+   
+  <link rel="stylesheet" href="_static/custom.css" type="text/css" />
+  
+  
+  <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
+
+  </head><body>
+  
+
+    <div class="document">
+      <div class="documentwrapper">
+        <div class="bodywrapper">
+          
+
+          <div class="body" role="main">
+            
+  <div class="section" id="version-scheme">
+<span id="versioning"></span><h1>Version Scheme<a class="headerlink" href="#version-scheme" title="Permalink to this headline">¶</a></h1>
+<p>Each firmware component has its own versioning scheme, and <cite>op-build</cite> brings
+all of these components together in one image with one global version
+number.</p>
+<p>Firmware versions are exposed to the user through both the device tree
+(<span class="xref std std-ref">device-tree/ibm,firmware-versions</span>) and the VERSION firmware
+partition. As such, firmware versioning numbers <strong>MUST</strong> follow the
+requirements in order for some functionality to be correct.</p>
+<dl class="docutils">
+<dt>skiboot</dt>
+<dd><a class="reference external" href="https://open-power.github.io/skiboot/doc/process/versioning.html#versioning" title="(in skiboot vv6.7-45-g4b9ca02)"><span>Versioning Scheme of skiboot</span></a></dd>
+<dt>Hostboot</dt>
+<dd>Currently just uses the git SHA1 of the commit</dd>
+<dt>OCC</dt>
+<dd>Currently just uses the git SHA1 of the commit</dd>
+<dt>Petitboot</dt>
+<dd>Uses a X.Y.Z versioning scheme.</dd>
+<dt>Linux</dt>
+<dd>We use the upstream Linux kernel version, and always append <code class="docutils literal notranslate"><span class="pre">-openpowerN</span></code>
+where N is a number starting at 1 that increases for each change we make
+to any additional patches carried in <cite>op-build</cite> for that specific kernel
+version.
+We follow the stable tree and have an “upstream <em>first</em>” policy in place.</dd>
+</dl>
+</div>
+
+
+          </div>
+          
+        </div>
+      </div>
+      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
+        <div class="sphinxsidebarwrapper">
+<h1 class="logo"><a href="index.html">OpenPOWER Firmware</a></h1>
+
+
+
+
+
+
+
+
+<h3>Navigation</h3>
+<p class="caption"><span class="caption-text">Contents:</span></p>
+<ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="introduction.html">Introduction to OpenPOWER Firmware</a></li>
+<li class="toctree-l1"><a class="reference internal" href="testing.html">Testing op-build</a></li>
+<li class="toctree-l1"><a class="reference internal" href="process/index.html">Development Process</a></li>
+<li class="toctree-l1"><a class="reference internal" href="boot-devices.html">Supported Boot Devices</a></li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Version Scheme</a></li>
+<li class="toctree-l1"><a class="reference internal" href="release-notes/index.html">op-build Release Notes</a></li>
+</ul>
+
+<div class="relations">
+<h3>Related Topics</h3>
+<ul>
+  <li><a href="index.html">Documentation overview</a><ul>
+      <li>Previous: <a href="boot-devices.html" title="previous chapter">Supported Boot Devices</a></li>
+      <li>Next: <a href="release-notes/index.html" title="next chapter">op-build Release Notes</a></li>
+  </ul></li>
+</ul>
+</div>
+<div id="searchbox" style="display: none" role="search">
+  <h3>Quick search</h3>
+    <div class="searchformwrapper">
+    <form class="search" action="search.html" method="get">
+      <input type="text" name="q" />
+      <input type="submit" value="Go" />
+      <input type="hidden" name="check_keywords" value="yes" />
+      <input type="hidden" name="area" value="default" />
+    </form>
+    </div>
+</div>
+<script type="text/javascript">$('#searchbox').show(0);</script>
+
+
+
+
+
+
+
+
+        </div>
+      </div>
+      <div class="clearer"></div>
+    </div>
+    <div class="footer">
+      &copy;2017, OpenPOWER Foundation System Software Work Group.
+      
+      |
+      Powered by <a href="http://sphinx-doc.org/">Sphinx 1.7.9</a>
+      &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
+      
+      |
+      <a href="_sources/versioning.rst.txt"
+          rel="nofollow">Page source</a>
+    </div>
+
+    
+
+    
+  </body>
+</html>
\ No newline at end of file