Deploy open-power/op-build to github.com/open-power/op-build.git:gh-pages
diff --git a/process/CONTRIBUTING.html b/process/CONTRIBUTING.html
new file mode 100644
index 0000000..7aea5de
--- /dev/null
+++ b/process/CONTRIBUTING.html
@@ -0,0 +1,220 @@
+
+<!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>Contributing to op-build — 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 Linux Kernel" href="KernelTree.html" />
+ <link rel="prev" title="Development Process" href="index.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="contributing-to-op-build">
+<h1>Contributing to op-build<a class="headerlink" href="#contributing-to-op-build" title="Permalink to this headline">¶</a></h1>
+<p>op-build is the open source build system for OpenPOWER firmware. It assembles
+many individual components (only a few of which are OpenPOWER specific) into
+a single firmware image. op-build is implemented as a buildroot overlay.</p>
+<p>If you haven’t already, join us on IRC (#openpower on Freenode) and on
+the mailing list ( openpower-firmware@lists.ozlabs.org - subscribe by
+going to https://lists.ozlabs.org/listinfo/openpower-firmware )</p>
+<p>We use GitHub Issues and Pull Requests for tracking contributions. We
+expect participants to adhere to the GitHub Community Guidelines (found
+at https://help.github.com/articles/github-community-guidelines/ ).</p>
+<p>If you are unable or unwilling to use GitHub, we can accept contributions
+via the mailing list.</p>
+<p>All contributions should have a Developer Certificate of Origin (see below).</p>
+<div class="section" id="development-philosophy">
+<h2>Development Philosophy<a class="headerlink" href="#development-philosophy" title="Permalink to this headline">¶</a></h2>
+<p>Our development philosophy is:</p>
+<ol class="simple">
+<li>Don’t re-invent the wheel</li>
+<li>Upstream first</li>
+</ol>
+<p>As such, we don’t like to carry patches in op-build, we prefer to interact
+with upstream projects and get patches accepted there. Where we do need
+to patch things locally, we prefer to carry backports from upstream, which
+can be removed when we move to more recent upstream.</p>
+</div>
+<div class="section" id="development-environment">
+<h2>Development Environment<a class="headerlink" href="#development-environment" title="Permalink to this headline">¶</a></h2>
+<p>For working on op-build you will need a reasonably recent Linux distribution.
+We aim to have all current major distros be suitable development platforms
+(focused on Ubuntu and Fedora, as that’s what most developers currently use).</p>
+<p>A host GCC of at least 4.9 is recommended (all modern Linux distributions
+provide this).</p>
+<p>You can build on x86-64, ppc64 or ppc64le, op-build will build appropriate
+cross-compilers for you (thanks to the magic of buildroot).</p>
+<p>You will need 8-15GB of disk space to do a full build of any one configuration.</p>
+</div>
+<div class="section" id="development-process">
+<h2>Development Process<a class="headerlink" href="#development-process" title="Permalink to this headline">¶</a></h2>
+<p>The main source repository is on GitHub. We use GitHub issues and pull requests
+as well as a mailing list (https://lists.ozlabs.org/listinfo/openpower-firmware).</p>
+<p>We tag a new op-build release roughly every 6 weeks.</p>
+<p>We use GitHub milestones: https://github.com/open-power/op-build/milestones</p>
+<p>Starting with the v1.15 release, active development occurs against the master
+branch. When we’re nearing a release, we move the content of the master branch
+over to a ‘release’ branch, ensuring development can continue while the release
+is prepared.</p>
+<p>We accept pull requests on GitHub: https://github.com/open-power/op-build/pulls</p>
+</div>
+<div class="section" id="developer-certificate-of-origin">
+<h2>Developer Certificate of Origin<a class="headerlink" href="#developer-certificate-of-origin" title="Permalink to this headline">¶</a></h2>
+<p>Contributions to this project should conform to the <code class="docutils literal notranslate"><span class="pre">Developer</span> <span class="pre">Certificate</span> <span class="pre">of</span> <span class="pre">Origin</span></code> as defined at http://elinux.org/Developer_Certificate_Of_Origin.
+Commits to this project need to contain the following line to indicate
+the submitter accepts the DCO:</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Signed</span><span class="o">-</span><span class="n">off</span><span class="o">-</span><span class="n">by</span><span class="p">:</span> <span class="n">Your</span> <span class="n">Name</span> <span class="o"><</span><span class="n">your_email</span><span class="nd">@domain</span><span class="o">.</span><span class="n">com</span><span class="o">></span>
+</pre></div>
+</div>
+<p>By contributing in this way, you agree to the terms as follows:</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Developer</span> <span class="n">Certificate</span> <span class="n">of</span> <span class="n">Origin</span>
+<span class="n">Version</span> <span class="mf">1.1</span>
+
+<span class="n">Copyright</span> <span class="p">(</span><span class="n">C</span><span class="p">)</span> <span class="mi">2004</span><span class="p">,</span> <span class="mi">2006</span> <span class="n">The</span> <span class="n">Linux</span> <span class="n">Foundation</span> <span class="ow">and</span> <span class="n">its</span> <span class="n">contributors</span><span class="o">.</span>
+<span class="mi">660</span> <span class="n">York</span> <span class="n">Street</span><span class="p">,</span> <span class="n">Suite</span> <span class="mi">102</span><span class="p">,</span>
+<span class="n">San</span> <span class="n">Francisco</span><span class="p">,</span> <span class="n">CA</span> <span class="mi">94110</span> <span class="n">USA</span>
+
+<span class="n">Everyone</span> <span class="ow">is</span> <span class="n">permitted</span> <span class="n">to</span> <span class="n">copy</span> <span class="ow">and</span> <span class="n">distribute</span> <span class="n">verbatim</span> <span class="n">copies</span> <span class="n">of</span> <span class="n">this</span>
+<span class="n">license</span> <span class="n">document</span><span class="p">,</span> <span class="n">but</span> <span class="n">changing</span> <span class="n">it</span> <span class="ow">is</span> <span class="ow">not</span> <span class="n">allowed</span><span class="o">.</span>
+
+
+<span class="n">Developer</span><span class="s1">'s Certificate of Origin 1.1</span>
+
+<span class="n">By</span> <span class="n">making</span> <span class="n">a</span> <span class="n">contribution</span> <span class="n">to</span> <span class="n">this</span> <span class="n">project</span><span class="p">,</span> <span class="n">I</span> <span class="n">certify</span> <span class="n">that</span><span class="p">:</span>
+
+<span class="p">(</span><span class="n">a</span><span class="p">)</span> <span class="n">The</span> <span class="n">contribution</span> <span class="n">was</span> <span class="n">created</span> <span class="ow">in</span> <span class="n">whole</span> <span class="ow">or</span> <span class="ow">in</span> <span class="n">part</span> <span class="n">by</span> <span class="n">me</span> <span class="ow">and</span> <span class="n">I</span>
+ <span class="n">have</span> <span class="n">the</span> <span class="n">right</span> <span class="n">to</span> <span class="n">submit</span> <span class="n">it</span> <span class="n">under</span> <span class="n">the</span> <span class="nb">open</span> <span class="n">source</span> <span class="n">license</span>
+ <span class="n">indicated</span> <span class="ow">in</span> <span class="n">the</span> <span class="n">file</span><span class="p">;</span> <span class="ow">or</span>
+
+<span class="p">(</span><span class="n">b</span><span class="p">)</span> <span class="n">The</span> <span class="n">contribution</span> <span class="ow">is</span> <span class="n">based</span> <span class="n">upon</span> <span class="n">previous</span> <span class="n">work</span> <span class="n">that</span><span class="p">,</span> <span class="n">to</span> <span class="n">the</span> <span class="n">best</span>
+ <span class="n">of</span> <span class="n">my</span> <span class="n">knowledge</span><span class="p">,</span> <span class="ow">is</span> <span class="n">covered</span> <span class="n">under</span> <span class="n">an</span> <span class="n">appropriate</span> <span class="nb">open</span> <span class="n">source</span>
+ <span class="n">license</span> <span class="ow">and</span> <span class="n">I</span> <span class="n">have</span> <span class="n">the</span> <span class="n">right</span> <span class="n">under</span> <span class="n">that</span> <span class="n">license</span> <span class="n">to</span> <span class="n">submit</span> <span class="n">that</span>
+ <span class="n">work</span> <span class="k">with</span> <span class="n">modifications</span><span class="p">,</span> <span class="n">whether</span> <span class="n">created</span> <span class="ow">in</span> <span class="n">whole</span> <span class="ow">or</span> <span class="ow">in</span> <span class="n">part</span>
+ <span class="n">by</span> <span class="n">me</span><span class="p">,</span> <span class="n">under</span> <span class="n">the</span> <span class="n">same</span> <span class="nb">open</span> <span class="n">source</span> <span class="n">license</span> <span class="p">(</span><span class="n">unless</span> <span class="n">I</span> <span class="n">am</span>
+ <span class="n">permitted</span> <span class="n">to</span> <span class="n">submit</span> <span class="n">under</span> <span class="n">a</span> <span class="n">different</span> <span class="n">license</span><span class="p">),</span> <span class="k">as</span> <span class="n">indicated</span>
+ <span class="ow">in</span> <span class="n">the</span> <span class="n">file</span><span class="p">;</span> <span class="ow">or</span>
+
+<span class="p">(</span><span class="n">c</span><span class="p">)</span> <span class="n">The</span> <span class="n">contribution</span> <span class="n">was</span> <span class="n">provided</span> <span class="n">directly</span> <span class="n">to</span> <span class="n">me</span> <span class="n">by</span> <span class="n">some</span> <span class="n">other</span>
+ <span class="n">person</span> <span class="n">who</span> <span class="n">certified</span> <span class="p">(</span><span class="n">a</span><span class="p">),</span> <span class="p">(</span><span class="n">b</span><span class="p">)</span> <span class="ow">or</span> <span class="p">(</span><span class="n">c</span><span class="p">)</span> <span class="ow">and</span> <span class="n">I</span> <span class="n">have</span> <span class="ow">not</span> <span class="n">modified</span>
+ <span class="n">it</span><span class="o">.</span>
+
+<span class="p">(</span><span class="n">d</span><span class="p">)</span> <span class="n">I</span> <span class="n">understand</span> <span class="ow">and</span> <span class="n">agree</span> <span class="n">that</span> <span class="n">this</span> <span class="n">project</span> <span class="ow">and</span> <span class="n">the</span> <span class="n">contribution</span>
+ <span class="n">are</span> <span class="n">public</span> <span class="ow">and</span> <span class="n">that</span> <span class="n">a</span> <span class="n">record</span> <span class="n">of</span> <span class="n">the</span> <span class="n">contribution</span> <span class="p">(</span><span class="n">including</span> <span class="nb">all</span>
+ <span class="n">personal</span> <span class="n">information</span> <span class="n">I</span> <span class="n">submit</span> <span class="k">with</span> <span class="n">it</span><span class="p">,</span> <span class="n">including</span> <span class="n">my</span> <span class="n">sign</span><span class="o">-</span><span class="n">off</span><span class="p">)</span> <span class="ow">is</span>
+ <span class="n">maintained</span> <span class="n">indefinitely</span> <span class="ow">and</span> <span class="n">may</span> <span class="n">be</span> <span class="n">redistributed</span> <span class="n">consistent</span> <span class="k">with</span>
+ <span class="n">this</span> <span class="n">project</span> <span class="ow">or</span> <span class="n">the</span> <span class="nb">open</span> <span class="n">source</span> <span class="n">license</span><span class="p">(</span><span class="n">s</span><span class="p">)</span> <span class="n">involved</span><span class="o">.</span>
+</pre></div>
+</div>
+</div>
+</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 current"><a class="reference internal" href="index.html">Development Process</a><ul class="current">
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Contributing to op-build</a></li>
+<li class="toctree-l2"><a class="reference internal" href="KernelTree.html">op-build Linux Kernel</a></li>
+<li class="toctree-l2"><a class="reference internal" href="building-with-ci.html">Building with ci scripts</a></li>
+<li class="toctree-l2"><a class="reference internal" href="stable-rules.html">op-build stable tree rules and releases</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../boot-devices.html">Supported Boot Devices</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../versioning.html">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><a href="index.html">Development Process</a><ul>
+ <li>Previous: <a href="index.html" title="previous chapter">Development Process</a></li>
+ <li>Next: <a href="KernelTree.html" title="next chapter">op-build Linux Kernel</a></li>
+ </ul></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">
+ ©2017, OpenPOWER Foundation System Software Work Group.
+
+ |
+ Powered by <a href="http://sphinx-doc.org/">Sphinx 1.7.9</a>
+ & <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
+
+ |
+ <a href="../_sources/process/CONTRIBUTING.md.txt"
+ rel="nofollow">Page source</a>
+ </div>
+
+
+
+
+ </body>
+</html>
\ No newline at end of file
diff --git a/process/KernelTree.html b/process/KernelTree.html
new file mode 100644
index 0000000..9bd246c
--- /dev/null
+++ b/process/KernelTree.html
@@ -0,0 +1,184 @@
+
+<!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>op-build Linux Kernel — 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="Building with ci scripts" href="building-with-ci.html" />
+ <link rel="prev" title="Contributing to op-build" href="CONTRIBUTING.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="op-build-linux-kernel">
+<h1>op-build Linux Kernel<a class="headerlink" href="#op-build-linux-kernel" title="Permalink to this headline">¶</a></h1>
+<p>The skiroot/Petitboot kernel is currently based on the 5.3 series.</p>
+<div class="section" id="submitting-a-patch">
+<h2>Submitting a patch<a class="headerlink" href="#submitting-a-patch" title="Permalink to this headline">¶</a></h2>
+<p>If you require a patch added to the firmware, follow these steps:</p>
+<ol class="arabic simple">
+<li>Submit your patch upstream. It doesn’t need to be upstream, but it
+should be on it’s way</li>
+<li>Send a pull request or a <code class="docutils literal notranslate"><span class="pre">git</span> <span class="pre">format-patch</span></code> formatted patch series
+to <a class="reference external" href="mailto:openpower-firmware%40lists.ozlabs.org">openpower-firmware<span>@</span>lists<span>.</span>ozlabs<span>.</span>org</a>, and cc <a class="reference external" href="mailto:joel%40jms.id.au">joel<span>@</span>jms<span>.</span>id<span>.</span>au</a>. Be
+sure to use <code class="docutils literal notranslate"><span class="pre">--suppress-cc=sob</span></code> when generating the patches so we
+don’t spam the community. The current tree is based on 5.1-stable
+(although we will always move to the latest stable kernel ASAP).</li>
+</ol>
+</div>
+<div class="section" id="bug-fixes">
+<h2>Bug fixes<a class="headerlink" href="#bug-fixes" title="Permalink to this headline">¶</a></h2>
+<p>Whenever a stable release is tagged in
+<a class="reference external" href="https://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/">https://git.kernel.org/cgit/linux/kernel/git/stable/linux-stable.git/</a>,
+we will rebase our patches on top of that and create a new release.</p>
+<p>If you are submitting patches upstream that you want to be included,
+then ensure you cc stable as per the
+<a class="reference external" href="https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/plain/Documentation/stable_kernel_rules.txt">rules</a>.</p>
+</div>
+<div class="section" id="versioning">
+<h2>Versioning<a class="headerlink" href="#versioning" title="Permalink to this headline">¶</a></h2>
+<p>Versions are the upstream version number, followed by <code class="docutils literal notranslate"><span class="pre">-openpowerN</span></code>,
+where N is the revision that counts up from 1 for the given upstream
+version number. These versions will be present as tags in the git
+repository hosted at <a class="reference external" href="https://github.com/open-power/linux">https://github.com/open-power/linux</a>.</p>
+<p>We aim to follow “the latest upstream release”.</p>
+<p>For op-build stable trees, we follow the latest stable release of the
+kernel that particular op-build release was made with. Since op-build
+stable releases may outlast how long an upstream kernel is maintain for,
+we will move up the kernel version we use until the next LTS kernel.
+Once on an LTS kernel, an op-build stable release will stick with that
+version.</p>
+</div>
+<div class="section" id="tree-and-patches">
+<h2>Tree and patches<a class="headerlink" href="#tree-and-patches" title="Permalink to this headline">¶</a></h2>
+<p>The kernel tree hosted at <a class="reference external" href="https://github.com/open-power/linux">https://github.com/open-power/linux</a> contains
+the current release plus a set of patches that we carry. Ideally there
+would be no patches carried, as everything should be upstream.</p>
+<p>We take the commits in this tree between the upstream tag and the
+openpower tag and generate a series of patches that are imported into
+the op-build Buildroot overlay, and placed in
+<a class="reference external" href="https://github.com/open-power/op-build/tree/master/openpower/linux">op-build/openpower/linux</a>.
+op-build then fetches the upstream tarball and applies these patches.
+This way we don’t have to clone an entire tree when doing an op-build
+build.</p>
+<p>All patches are to head upstream <em>first</em>. There is a zero chance that
+op-build will carry kernel patches for any time greater than “until the
+next kernel release”, and even then, only in <em>exceptional</em> circumstances.</p>
+</div>
+<div class="section" id="patches-in-the-tree">
+<h2>Patches in the tree<a class="headerlink" href="#patches-in-the-tree" title="Permalink to this headline">¶</a></h2>
+<ul class="simple">
+<li>xhci: Reset controller on xhci shutdown</li>
+</ul>
+</div>
+</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 current"><a class="reference internal" href="index.html">Development Process</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="CONTRIBUTING.html">Contributing to op-build</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">op-build Linux Kernel</a></li>
+<li class="toctree-l2"><a class="reference internal" href="building-with-ci.html">Building with ci scripts</a></li>
+<li class="toctree-l2"><a class="reference internal" href="stable-rules.html">op-build stable tree rules and releases</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../boot-devices.html">Supported Boot Devices</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../versioning.html">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><a href="index.html">Development Process</a><ul>
+ <li>Previous: <a href="CONTRIBUTING.html" title="previous chapter">Contributing to op-build</a></li>
+ <li>Next: <a href="building-with-ci.html" title="next chapter">Building with ci scripts</a></li>
+ </ul></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">
+ ©2017, OpenPOWER Foundation System Software Work Group.
+
+ |
+ Powered by <a href="http://sphinx-doc.org/">Sphinx 1.7.9</a>
+ & <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
+
+ |
+ <a href="../_sources/process/KernelTree.rst.txt"
+ rel="nofollow">Page source</a>
+ </div>
+
+
+
+
+ </body>
+</html>
\ No newline at end of file
diff --git a/process/building-with-ci.html b/process/building-with-ci.html
new file mode 100644
index 0000000..8f6b01a
--- /dev/null
+++ b/process/building-with-ci.html
@@ -0,0 +1,131 @@
+
+<!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>Building with ci scripts — 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 stable tree rules and releases" href="stable-rules.html" />
+ <link rel="prev" title="op-build Linux Kernel" href="KernelTree.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="building-with-ci-scripts">
+<h1>Building with ci scripts<a class="headerlink" href="#building-with-ci-scripts" title="Permalink to this headline">¶</a></h1>
+<p>op-build has several build scripts in the ci/ directory aimed at being used to
+help continuous integration environments, as well as specifying build
+dependencies as code.</p>
+<p>These use Docker containers for the build environment.</p>
+<p>It is recommended you use (or send patches so that you can use them) these over
+rolling your own scripts.</p>
+</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 current"><a class="reference internal" href="index.html">Development Process</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="CONTRIBUTING.html">Contributing to op-build</a></li>
+<li class="toctree-l2"><a class="reference internal" href="KernelTree.html">op-build Linux Kernel</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Building with ci scripts</a></li>
+<li class="toctree-l2"><a class="reference internal" href="stable-rules.html">op-build stable tree rules and releases</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../boot-devices.html">Supported Boot Devices</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../versioning.html">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><a href="index.html">Development Process</a><ul>
+ <li>Previous: <a href="KernelTree.html" title="previous chapter">op-build Linux Kernel</a></li>
+ <li>Next: <a href="stable-rules.html" title="next chapter">op-build stable tree rules and releases</a></li>
+ </ul></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">
+ ©2017, OpenPOWER Foundation System Software Work Group.
+
+ |
+ Powered by <a href="http://sphinx-doc.org/">Sphinx 1.7.9</a>
+ & <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
+
+ |
+ <a href="../_sources/process/building-with-ci.rst.txt"
+ rel="nofollow">Page source</a>
+ </div>
+
+
+
+
+ </body>
+</html>
\ No newline at end of file
diff --git a/process/index.html b/process/index.html
new file mode 100644
index 0000000..621d5e3
--- /dev/null
+++ b/process/index.html
@@ -0,0 +1,149 @@
+
+<!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>Development Process — 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="Contributing to op-build" href="CONTRIBUTING.html" />
+ <link rel="prev" title="Testing op-build" href="../testing.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="development-process">
+<h1>Development Process<a class="headerlink" href="#development-process" title="Permalink to this headline">¶</a></h1>
+<div class="toctree-wrapper compound">
+<ul>
+<li class="toctree-l1"><a class="reference internal" href="CONTRIBUTING.html">Contributing to op-build</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="CONTRIBUTING.html#development-philosophy">Development Philosophy</a></li>
+<li class="toctree-l2"><a class="reference internal" href="CONTRIBUTING.html#development-environment">Development Environment</a></li>
+<li class="toctree-l2"><a class="reference internal" href="CONTRIBUTING.html#development-process">Development Process</a></li>
+<li class="toctree-l2"><a class="reference internal" href="CONTRIBUTING.html#developer-certificate-of-origin">Developer Certificate of Origin</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="KernelTree.html">op-build Linux Kernel</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="KernelTree.html#submitting-a-patch">Submitting a patch</a></li>
+<li class="toctree-l2"><a class="reference internal" href="KernelTree.html#bug-fixes">Bug fixes</a></li>
+<li class="toctree-l2"><a class="reference internal" href="KernelTree.html#versioning">Versioning</a></li>
+<li class="toctree-l2"><a class="reference internal" href="KernelTree.html#tree-and-patches">Tree and patches</a></li>
+<li class="toctree-l2"><a class="reference internal" href="KernelTree.html#patches-in-the-tree">Patches in the tree</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="building-with-ci.html">Building with ci scripts</a></li>
+<li class="toctree-l1"><a class="reference internal" href="stable-rules.html">op-build stable tree rules and releases</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="stable-rules.html#what-patches-are-accepted">What patches are accepted?</a></li>
+<li class="toctree-l2"><a class="reference internal" href="stable-rules.html#howto-submit-to-stable">HOWTO submit to stable</a></li>
+<li class="toctree-l2"><a class="reference internal" href="stable-rules.html#trees">Trees</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</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 current"><a class="current reference internal" href="#">Development Process</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="CONTRIBUTING.html">Contributing to op-build</a></li>
+<li class="toctree-l2"><a class="reference internal" href="KernelTree.html">op-build Linux Kernel</a></li>
+<li class="toctree-l2"><a class="reference internal" href="building-with-ci.html">Building with ci scripts</a></li>
+<li class="toctree-l2"><a class="reference internal" href="stable-rules.html">op-build stable tree rules and releases</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../boot-devices.html">Supported Boot Devices</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../versioning.html">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="../testing.html" title="previous chapter">Testing op-build</a></li>
+ <li>Next: <a href="CONTRIBUTING.html" title="next chapter">Contributing to op-build</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">
+ ©2017, OpenPOWER Foundation System Software Work Group.
+
+ |
+ Powered by <a href="http://sphinx-doc.org/">Sphinx 1.7.9</a>
+ & <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
+
+ |
+ <a href="../_sources/process/index.rst.txt"
+ rel="nofollow">Page source</a>
+ </div>
+
+
+
+
+ </body>
+</html>
\ No newline at end of file
diff --git a/process/stable-rules.html b/process/stable-rules.html
new file mode 100644
index 0000000..7e77339
--- /dev/null
+++ b/process/stable-rules.html
@@ -0,0 +1,205 @@
+
+<!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>op-build stable tree rules and releases — 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="Supported Boot Devices" href="../boot-devices.html" />
+ <link rel="prev" title="Building with ci scripts" href="building-with-ci.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="op-build-stable-tree-rules-and-releases">
+<span id="stable-rules"></span><h1>op-build stable tree rules and releases<a class="headerlink" href="#op-build-stable-tree-rules-and-releases" title="Permalink to this headline">¶</a></h1>
+<p>Our stable tree process follows processes similar to other open source projects
+such as the Linux Kernel and Buildroot, as do several OpenPOWER Firmware
+components such as Skiboot and Petitboot.</p>
+<p>The purpose of a -stable tree is to give vendors a stable base to create
+firmware releases from and to incorporate into service packs. New stable
+releases contain critical fixes only.</p>
+<p>As a general rule, only the most recent op-build release gets a maintained
+-stable tree. If you wish to maintain an older tree, speak up! For example,
+with my IBMer hat on, we’ll maintain branches that we ship in products.</p>
+<div class="section" id="what-patches-are-accepted">
+<h2>What patches are accepted?<a class="headerlink" href="#what-patches-are-accepted" title="Permalink to this headline">¶</a></h2>
+<ul class="simple">
+<li>Patches must be obviously correct and tested<ul>
+<li>A Tested-by signoff is <em>important</em></li>
+</ul>
+</li>
+<li>A patch must fix a real bug</li>
+<li>No trivial patches, such fixups belong in main branch</li>
+<li>Not fix a purely theoretical problem unless you can prove how
+it’s exploitable</li>
+<li>The patch, or an equivalent one, must already be in master<ul>
+<li>Submitting to both at the same time is okay, but back-porting is better</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="section" id="howto-submit-to-stable">
+<h2>HOWTO submit to stable<a class="headerlink" href="#howto-submit-to-stable" title="Permalink to this headline">¶</a></h2>
+<ol class="arabic">
+<li><p class="first">Make a pull request with “[stable op-build-N.N.y]” in subject (where N.N.y
+is the stable branch to which you are targeting)</p>
+<ul>
+<li><p class="first">This targets the patch <em>ONLY</em> to the stable branch.</p>
+<ul class="simple">
+<li>Such commits will <em>NOT</em> be merged into master.</li>
+</ul>
+</li>
+<li><p class="first">Use this when:</p>
+<ol class="loweralpha simple">
+<li>cherry-picking a fix from master</li>
+<li>fixing something that is only broken in stable</li>
+<li>fix in stable needs to be completely different than in master</li>
+</ol>
+<p>If b or c: explain why.</p>
+</li>
+<li><p class="first">If cherry-picking, include the following at the top of your
+commit message (or use the -x option to git-cherry-pick):</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">commit</span> <span class="o"><</span><span class="n">sha1</span><span class="o">></span> <span class="n">upstream</span><span class="o">.</span>
+</pre></div>
+</div>
+</li>
+<li><p class="first">If the patch has been modified, explain why in description.</p>
+</li>
+</ul>
+</li>
+<li><p class="first">Add a comment on the PR indicating that a PR should also go to a stable
+branch when making a Pull request to master</p>
+<ul class="simple">
+<li>This targets the patch to master and stable.</li>
+<li>You can target a patch to a specific stable tree by putting that in the
+comment</li>
+<li>You can ask for prerequisites to be cherry-picked.</li>
+</ul>
+</li>
+</ol>
+</div>
+<div class="section" id="trees">
+<h2>Trees<a class="headerlink" href="#trees" title="Permalink to this headline">¶</a></h2>
+<ul class="simple">
+<li><a class="reference external" href="https://github.com/open-power/op-build/">https://github.com/open-power/op-build/</a> (or via ssh at <code class="docutils literal notranslate"><span class="pre">git@github.com:open-power/op-build.git</span></code> )<ul>
+<li>(branches are op-build-X.Y.y - e.g. op-build-2.0.y)</li>
+</ul>
+</li>
+<li>Some stable versions may last longer than others<ul>
+<li>So there may be op-build-2.0.y and op-build-2.4.y actively maintained
+and op-build-2.0.y could possibly outlast op-build-2.4.y.</li>
+</ul>
+</li>
+</ul>
+</div>
+</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 current"><a class="reference internal" href="index.html">Development Process</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="CONTRIBUTING.html">Contributing to op-build</a></li>
+<li class="toctree-l2"><a class="reference internal" href="KernelTree.html">op-build Linux Kernel</a></li>
+<li class="toctree-l2"><a class="reference internal" href="building-with-ci.html">Building with ci scripts</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">op-build stable tree rules and releases</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../boot-devices.html">Supported Boot Devices</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../versioning.html">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><a href="index.html">Development Process</a><ul>
+ <li>Previous: <a href="building-with-ci.html" title="previous chapter">Building with ci scripts</a></li>
+ <li>Next: <a href="../boot-devices.html" title="next chapter">Supported Boot Devices</a></li>
+ </ul></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">
+ ©2017, OpenPOWER Foundation System Software Work Group.
+
+ |
+ Powered by <a href="http://sphinx-doc.org/">Sphinx 1.7.9</a>
+ & <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
+
+ |
+ <a href="../_sources/process/stable-rules.rst.txt"
+ rel="nofollow">Page source</a>
+ </div>
+
+
+
+
+ </body>
+</html>
\ No newline at end of file