hadoop-common-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From w...@apache.org
Subject svn commit: r1755112 - in /hadoop/common/site/main: author/src/documentation/content/xdocs/ publish/
Date Wed, 03 Aug 2016 20:40:16 GMT
Author: wang
Date: Wed Aug  3 20:40:16 2016
New Revision: 1755112

URL: http://svn.apache.org/viewvc?rev=1755112&view=rev
Log:
Publish committer criteria and versioning pages.

Added:
    hadoop/common/site/main/author/src/documentation/content/xdocs/committer_criteria.xml
    hadoop/common/site/main/author/src/documentation/content/xdocs/versioning.xml
    hadoop/common/site/main/publish/committer_criteria.html
    hadoop/common/site/main/publish/committer_criteria.pdf   (with props)
    hadoop/common/site/main/publish/versioning.html
    hadoop/common/site/main/publish/versioning.pdf   (with props)
Removed:
    hadoop/common/site/main/author/src/documentation/content/xdocs/committer_criteria.html
    hadoop/common/site/main/author/src/documentation/content/xdocs/versioning.html
Modified:
    hadoop/common/site/main/author/src/documentation/content/xdocs/site.xml
    hadoop/common/site/main/publish/bylaws.html
    hadoop/common/site/main/publish/bylaws.pdf
    hadoop/common/site/main/publish/index.html
    hadoop/common/site/main/publish/index.pdf
    hadoop/common/site/main/publish/issue_tracking.html
    hadoop/common/site/main/publish/issue_tracking.pdf
    hadoop/common/site/main/publish/linkmap.html
    hadoop/common/site/main/publish/linkmap.pdf
    hadoop/common/site/main/publish/mailing_lists.html
    hadoop/common/site/main/publish/mailing_lists.pdf
    hadoop/common/site/main/publish/privacy_policy.html
    hadoop/common/site/main/publish/privacy_policy.pdf
    hadoop/common/site/main/publish/releases.html
    hadoop/common/site/main/publish/releases.pdf
    hadoop/common/site/main/publish/version_control.html
    hadoop/common/site/main/publish/version_control.pdf
    hadoop/common/site/main/publish/who.html
    hadoop/common/site/main/publish/who.pdf

Added: hadoop/common/site/main/author/src/documentation/content/xdocs/committer_criteria.xml
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/author/src/documentation/content/xdocs/committer_criteria.xml?rev=1755112&view=auto
==============================================================================
--- hadoop/common/site/main/author/src/documentation/content/xdocs/committer_criteria.xml (added)
+++ hadoop/common/site/main/author/src/documentation/content/xdocs/committer_criteria.xml Wed Aug  3 20:40:16 2016
@@ -0,0 +1,37 @@
+<?xml version="1.0"?>
+
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" 
+          "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document> 
+
+  <header> 
+    <title>Committer Criteria</title> 
+  </header> 
+
+  <body> 
+
+    <section><title>Criteria for Committership</title>
+        <p>Committers are responsible for reviewing and integrating code changes. The PMC votes to make a contributor a committer based on an assessment of their contributions to the project. Contributions can be made in many ways, and there is no one route to committership. That said, here are the general criteria that the PMC looks for from all potential committers:</p>
+
+        <ul>
+            <li><strong>A history of sustained contribution to the project.</strong> This is a way for a contributor to demonstrate their expertise in an area, and thus their ability to help review and commit contributions by others in that same area. Sustained contribution is also a way of demonstrating commitment to the project, essentially that someone will continue contributing even after they become a committer.</li>
+            <li><strong>High-quality contributions.</strong> As experienced contributors, committers set an example for others in the project, and help inculcate a culture of high-quality contributions. For code contributions, this means clean, documented code which includes unit tests if appropriate and passes precommit checks. For reviews, this means thorough, actionable feedback, and a +1 vote (even non-binding) only when there is a high degree of confidence in the change.</li>
+            <li><strong>Community involvement.</strong> Contributors are always expected to be polite, constructive, and respectful of others during community interactions. Disagreement can (and will) happen over technical issues, but the discussion should remain friendly and focused on technical merits. Committers also have the additional responsibility of mentoring newer contributors, as well as helping to grow the community through actions like responding to emails on the user and dev list.</li>
+        </ul>
+    </section>
+
+    <section><title>Example Paths to Committership</title>
+        <p>Here are a few hypothetical example paths to a commit bit:</p>
+
+        <p><em>Han Meimei</em> works at a big company operating a large Apache Hadoop cluster. While deploying the newest version of Hadoop to her staging cluster, she discovers a number of bugs and performance regressions. She files JIRAs for these issues, and is able to post patches for some of them. On the remaining JIRAs, she works with other community members by doing additional debugging on her cluster and testing and reviewing intermediate patches. Additionally, Han Meimei works with the release manager of the release line, <em>Lei Li</em>, to make sure critical issues are backported to the next maintenance release. Han Meimei also makes an effort to help fix and review other critical issues targeted at the next maintenance release, even though her cluster is not currently affected. She continues doing similar stabilization work for subsequent maintenance releases in this release line, demonstrating her commitment to shipping high-quality upstream releases.</p>
+
+        <p><em>Elise</em> works at a commercial big data vendor as a developer. Elise ramps up by doing some newbie JIRAs, but then gets involved with a large cross-company development effort happening on a feature branch. Elise helps to review the design of the feature, providing constructive feedback, and works with other community members to divide the work into subtasks. At this point, the PMC grants Elise branch committership to accelerate development. Elise submits good patches for a number of subtasks, and shows care and thoroughness when reviewing and committing code of others. After the feature branch is later merged to trunk, Elise continues to find and fix bugs related to the feature, as well as reviewing code contributions from others.</p>
+
+        <p><em>Raj</em> works as a test engineer at a commercial big data vendor. Raj notices the lack of integration testing upstream, and contributes a test harness for fault-injection testing which is committed to the project. Raj coordinates with the PMC to get the test harness running on Apache infrastructure, and starts triaging the output and filing JIRAs for relevant bugs with reproductions. Raj helps with gathering logs and reproducing issues, and continues making improvements to the test harness.</p>
+
+        <p><em>Peter</em> is a technical writer interested in improving Hadoop's documentation. He starts by fixing outdated information and incorrect examples, reaching out to subject matter experts and exploring the codebase to clarify technical details. As Peter becomes more familiar with the set of documentation, he realizes that a newly contributed feature didn't include sufficient documentation, and contributes a guide on how to setup and use the feature that also explains some of the design decisions that influenced API design. Peter continues to broaden his doc contributions to more and more areas, and also is active answering user questions on the mailing list. This demonstrates his knowledge of the project, attention to detail, and also his user-focus.</p>
+   </section>
+</body>
+
+</document>

Modified: hadoop/common/site/main/author/src/documentation/content/xdocs/site.xml
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/author/src/documentation/content/xdocs/site.xml?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
--- hadoop/common/site/main/author/src/documentation/content/xdocs/site.xml (original)
+++ hadoop/common/site/main/author/src/documentation/content/xdocs/site.xml Wed Aug  3 20:40:16 2016
@@ -20,6 +20,7 @@
   <project label="About">
     <news       label="Welcome"          href="index.html" />    
     <releases   label="Releases"         href="releases.html" />
+    <versioning       label="Release Versioning" href="versioning.html"/>
     <mail         label="Mailing Lists"     href="mailing_lists.html" />    
     <issues      label="Issue Tracking" href="issue_tracking.html" />    
     <who         label="Who We Are?"   href="who.html" />    
@@ -30,7 +31,6 @@
     <privacy      label="Privacy Policy" href="privacy_policy.html" />    
     <bylaws       label="Bylaws" href="bylaws.html"/>
     <committer       label="Committer criteria" href="committer_criteria.html"/>
-    <versioning       label="Release Versioning" href="versioning.html"/>
     <license label="License" href="ext:license" />
   </project>
 

Added: hadoop/common/site/main/author/src/documentation/content/xdocs/versioning.xml
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/author/src/documentation/content/xdocs/versioning.xml?rev=1755112&view=auto
==============================================================================
--- hadoop/common/site/main/author/src/documentation/content/xdocs/versioning.xml (added)
+++ hadoop/common/site/main/author/src/documentation/content/xdocs/versioning.xml Wed Aug  3 20:40:16 2016
@@ -0,0 +1,70 @@
+<?xml version="1.0"?>
+
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" 
+          "http://forrest.apache.org/dtd/document-v20.dtd">
+
+<document> 
+
+  <header> 
+    <title>Apache Hadoop Release Versioning</title> 
+  </header> 
+
+  <body> 
+
+      <section><title>Background</title>
+        <p>Apache Hadoop uses a version format of <strong>&lt;major&gt;.&lt;minor&gt;.&lt;maintenance&gt;</strong>, where each version component is a numeric value. Versions can also have additional suffixes like <em>"-alpha2"</em> or <em>"-beta1"</em>, which denote the API compatibility guarantees and quality of the release. We use <em>"a.b.c"</em> and <em>"x.y.z"</em> to denote a dotted version triplet.</p>
+          <p>Major versions are used to introduce substantial, potentially incompatible, changes. Examples of this include the replacement of MapReduce 1 with YARN and MapReduce 2 in Hadoop 2, and the required Java runtime version from JDK7 to JDK8 in Hadoop 3.</p>
+          <p>Minor versions are used to introduce new compatible features within a major release line.</p>
+          <p>Maintenance releases include bug fixes or low-risk supportability changes.</p>
+          <p>Hadoop's versioning scheme has evolved over the years. The early days of 0.20.2 leading up to the 1.y releases saw a <a href="http://blog.cloudera.com/blog/2012/01/an-update-on-apache-hadoop-1-0/">plethora of parallel releases</a> with different featuresets. Release activities coalesced in the early 2.y release era, with a mostly linear progression of releases from 2.0.0 through 2.7.0.</p>
+          <p>However, the ongoing maintenance of the 2.6.z and 2.7.z re-introduced parallel active release lines to Hadoop. Additional plans for 2.8.z and 3.0.z releases mean potentially four active release lines, necessitating clarification on Hadoop versioning and how it affects these parallel release branches.</p>
+      </section>
+
+      <section><title>Versioning rules</title>
+          <p>To establish a common foundation of knowledge, we require the following in terms of release versions.</p>
+
+          <ul>
+              <li>For <strong>a.b.c </strong>(maintenance) releases, the "c"s need to be released in order.</li>
+              <li>For <strong>a.b.0</strong> (minor) releases, the "b"s need to be released in order.</li>
+                <li>For <strong>a.0.0</strong> (major) releases, it comes after a specific x.y.0 minor release.</li>
+          </ul>
+
+          <p>This means that new major releases need to be coordinated with the previous minor release. New minor and maintenance releases only require coordination within their release line.</p>
+
+          <p><em>"-alphaX"</em> and <em>"-betaX"</em> suffixed version can be treated as a.b.c versions, with the first (e.g. <em>"-alpha1"</em>) being the a.b.0 release.</p>
+
+          <p>When it comes to setting fix versions, this policy is encoded by the following set of rules:</p>
+
+          <ol>
+            <li>For each <strong>minor</strong> release line, set the <strong>lowest unreleased a.b.c version, where c &ge; 0</strong>.</li>
+              <li>For each <strong>major</strong> release line, set the <strong>lowest unreleased a.b.0 version</strong>.</li>
+          </ol>
+
+      </section>
+      <section><title>Example</title>
+          <p>As an example, as of August 3rd, 2016, the latest releases in the 2.6.x and 2.7.x lines are 2.6.4 and 2.7.2. We have also cut the following branches for planned future releases: branch-2.7.3, branch-2.8, and branch-3.0.0-alpha1.</p>
+
+          <p>If we are committing a bugfix that is intended for the 2.6.5 release, we would commit to:</p>
+
+          <ol>
+              <li>trunk (3.0.0-alpha2)</li>
+              <li>branch-3.0.0-alpha1 (3.0.0-alpha1)</li>
+              <li>branch-2 (2.9.0)</li>
+              <li>branch-2.8 (2.8.0)</li>
+              <li>branch-2.7 (2.7.4)</li>
+              <li>branch-2.7.3 (2.7.3)</li>
+              <li>branch-2.6 (2.6.5)</li>
+          </ol>
+
+          <p>Applying the above rules for setting fix versions:</p>
+
+          <ol>
+              <li>Rule 1: 2.6.z and 2.7.z are both minor release lines, so set <strong>2.6.5</strong> and <strong>2.7.3</strong></li>
+              <li>Rule 2: 2.y.z and 3.y.z the major release lines, so set <strong>2.8.0</strong> and <strong>3.0.0-alpha1</strong></li>
+          </ol>
+
+          <p>Note that when backporting changes, we always make sure to backport to the next higher release in a release line. For instance, we make sure to backport to branch-2.7 (2.7.4) when backporting to branch-2.7.3 (2.7.3), and to branch-2 (2.9.0) when backporting to branch-2.8 (2.8.0). This preserves the monotonicity of releases.</p>
+      </section>
+  </body>
+
+</document>

Modified: hadoop/common/site/main/publish/bylaws.html
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/bylaws.html?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
--- hadoop/common/site/main/publish/bylaws.html (original)
+++ hadoop/common/site/main/publish/bylaws.html Wed Aug  3 20:40:16 2016
@@ -122,6 +122,9 @@ document.write("Last Published: " + docu
 <a href="releases.html">Releases</a>
 </div>
 <div class="menuitem">
+<a href="versioning.html">Release Versioning</a>
+</div>
+<div class="menuitem">
 <a href="mailing_lists.html">Mailing Lists</a>
 </div>
 <div class="menuitem">
@@ -160,6 +163,9 @@ document.write("Last Published: " + docu
 </div>
 </div>
 <div class="menuitem">
+<a href="committer_criteria.html">Committer criteria</a>
+</div>
+<div class="menuitem">
 <a href="http://www.apache.org/licenses/">License</a>
 </div>
 </div>

Modified: hadoop/common/site/main/publish/bylaws.pdf
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/bylaws.pdf?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
Binary files - no diff available.

Added: hadoop/common/site/main/publish/committer_criteria.html
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/committer_criteria.html?rev=1755112&view=auto
==============================================================================
--- hadoop/common/site/main/publish/committer_criteria.html (added)
+++ hadoop/common/site/main/publish/committer_criteria.html Wed Aug  3 20:40:16 2016
@@ -0,0 +1,316 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.9">
+<meta name="Forrest-skin-name" content="hadoop-pelt">
+<title>Committer Criteria</title>
+<link type="text/css" href="skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="skin/print.css" rel="stylesheet">
+<link type="text/css" href="skin/profile.css" rel="stylesheet">
+<script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="images/favicon.ico">
+<script type="text/javascript">
+
+  var _gaq = _gaq || [];
+  _gaq.push(['_setAccount', 'UA-7453027-1']);
+  _gaq.push(['_setDomainName', 'apache.org']);
+  _gaq.push(['_trackPageview']);
+
+  (function() {
+    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+  })();
+
+        </script>
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://hadoop.apache.org/">Hadoop</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http://www.apache.org"><img class="logoImage" alt="Apache" src="images/apache_feather.gif" title="Apache Software Foundation"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://hadoop.apache.org/"><img class="logoImage" alt="Hadoop" src="images/hadoop-logo.jpg" title="Scalable Distributed Computing"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://search-hadoop.com/" method="get">
+<input onFocus="getBlank (this, 'Search with Apache Solr');" size="25" name="q" id="query" type="text" value="Search with Apache Solr">&nbsp;
+		  <input value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li class="current">
+<a class="selected" href="index.html">Top</a>
+</li>
+<li>
+<a class="unselected" href="http://wiki.apache.org/hadoop">Wiki</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', 'skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">About</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="index.html">Welcome</a>
+</div>
+<div class="menuitem">
+<a href="releases.html">Releases</a>
+</div>
+<div class="menuitem">
+<a href="versioning.html">Release Versioning</a>
+</div>
+<div class="menuitem">
+<a href="mailing_lists.html">Mailing Lists</a>
+</div>
+<div class="menuitem">
+<a href="issue_tracking.html">Issue Tracking</a>
+</div>
+<div class="menuitem">
+<a href="who.html">Who We Are?</a>
+</div>
+<div class="menuitem">
+<a href="http://wiki.apache.org/hadoop/PoweredBy">Who Uses Hadoop?</a>
+</div>
+<div class="menuitem">
+<a href="http://www.cafepress.com/hadoop/">Buy Stuff</a>
+</div>
+<div class="menuitem">
+<a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
+</div>
+<div class="menuitem">
+<a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</div>
+<div class="menuitem">
+<a href="privacy_policy.html">Privacy Policy</a>
+</div>
+<div class="menuitem">
+<a href="bylaws.html">Bylaws</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Committer criteria</div>
+<div class="menupageitemgroup">
+<div class="menupageitem">
+<a title="Criteria for Committership" href="#Criteria+for+Committership">Criteria for Commit...</a>
+</div>
+<div class="menupageitem">
+<a title="Example Paths to Committership" href="#Example+Paths+to+Committership">Example Paths to Co...</a>
+</div>
+</div>
+</div>
+<div class="menuitem">
+<a href="http://www.apache.org/licenses/">License</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', 'skin/')" id="menu_1.2Title" class="menutitle">Documentation</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/current/">Current</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/stable/">Stable</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/r1.2.1/">Release 1.2.1</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/r2.5.2/">Release 2.5.2</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/r2.6.4/">Release 2.6.4</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/r0.23.11/">Release 0.23.11</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/r2.7.2/">Release 2.7.2</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', 'skin/')" id="menu_1.3Title" class="menutitle">Related Projects</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a href="http://incubator.apache.org/ambari/">Ambari</a>
+</div>
+<div class="menuitem">
+<a href="http://avro.apache.org/">Avro</a>
+</div>
+<div class="menuitem">
+<a href="http://cassandra.apache.org/">Cassandra</a>
+</div>
+<div class="menuitem">
+<a href="http://incubator.apache.org/chukwa/">Chukwa</a>
+</div>
+<div class="menuitem">
+<a href="http://incubator.apache.org/hama/">Hama</a>
+</div>
+<div class="menuitem">
+<a href="http://hbase.apache.org/">HBase</a>
+</div>
+<div class="menuitem">
+<a href="http://hive.apache.org/">Hive</a>
+</div>
+<div class="menuitem">
+<a href="http://mahout.apache.org/">Mahout</a>
+</div>
+<div class="menuitem">
+<a href="http://pig.apache.org/">Pig</a>
+</div>
+<div class="menuitem">
+<a href="http://spark.incubator.apache.org/">Spark</a>
+</div>
+<div class="menuitem">
+<a href="http://tez.incubator.apache.org/">Tez</a>
+</div>
+<div class="menuitem">
+<a href="http://zookeeper.apache.org/">ZooKeeper</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+<div id="credit2"></div>
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="committer_criteria.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
+        PDF</a>
+</div>
+<h1>Committer Criteria</h1> 
+
+    
+<a name="N1000D"></a><a name="Criteria+for+Committership"></a>
+<h2 class="h3">Criteria for Committership</h2>
+<div class="section">
+<p>Committers are responsible for reviewing and integrating code changes. The PMC votes to make a contributor a committer based on an assessment of their contributions to the project. Contributions can be made in many ways, and there is no one route to committership. That said, here are the general criteria that the PMC looks for from all potential committers:</p>
+<ul>
+            
+<li>
+<strong>A history of sustained contribution to the project.</strong> This is a way for a contributor to demonstrate their expertise in an area, and thus their ability to help review and commit contributions by others in that same area. Sustained contribution is also a way of demonstrating commitment to the project, essentially that someone will continue contributing even after they become a committer.</li>
+            
+<li>
+<strong>High-quality contributions.</strong> As experienced contributors, committers set an example for others in the project, and help inculcate a culture of high-quality contributions. For code contributions, this means clean, documented code which includes unit tests if appropriate and passes precommit checks. For reviews, this means thorough, actionable feedback, and a +1 vote (even non-binding) only when there is a high degree of confidence in the change.</li>
+            
+<li>
+<strong>Community involvement.</strong> Contributors are always expected to be polite, constructive, and respectful of others during community interactions. Disagreement can (and will) happen over technical issues, but the discussion should remain friendly and focused on technical merits. Committers also have the additional responsibility of mentoring newer contributors, as well as helping to grow the community through actions like responding to emails on the user and dev list.</li>
+        
+</ul>
+</div>
+
+    
+<a name="N10028"></a><a name="Example+Paths+to+Committership"></a>
+<h2 class="h3">Example Paths to Committership</h2>
+<div class="section">
+<p>Here are a few hypothetical example paths to a commit bit:</p>
+<p>
+<em>Han Meimei</em> works at a big company operating a large Apache Hadoop cluster. While deploying the newest version of Hadoop to her staging cluster, she discovers a number of bugs and performance regressions. She files JIRAs for these issues, and is able to post patches for some of them. On the remaining JIRAs, she works with other community members by doing additional debugging on her cluster and testing and reviewing intermediate patches. Additionally, Han Meimei works with the release manager of the release line, <em>Lei Li</em>, to make sure critical issues are backported to the next maintenance release. Han Meimei also makes an effort to help fix and review other critical issues targeted at the next maintenance release, even though her cluster is not currently affected. She continues doing similar stabilization work for subsequent maintenance releases in this release line, demonstrating her commitment to shipping high-quality upstream releases.</p>
+<p>
+<em>Elise</em> works at a commercial big data vendor as a developer. Elise ramps up by doing some newbie JIRAs, but then gets involved with a large cross-company development effort happening on a feature branch. Elise helps to review the design of the feature, providing constructive feedback, and works with other community members to divide the work into subtasks. At this point, the PMC grants Elise branch committership to accelerate development. Elise submits good patches for a number of subtasks, and shows care and thoroughness when reviewing and committing code of others. After the feature branch is later merged to trunk, Elise continues to find and fix bugs related to the feature, as well as reviewing code contributions from others.</p>
+<p>
+<em>Raj</em> works as a test engineer at a commercial big data vendor. Raj notices the lack of integration testing upstream, and contributes a test harness for fault-injection testing which is committed to the project. Raj coordinates with the PMC to get the test harness running on Apache infrastructure, and starts triaging the output and filing JIRAs for relevant bugs with reproductions. Raj helps with gathering logs and reproducing issues, and continues making improvements to the test harness.</p>
+<p>
+<em>Peter</em> is a technical writer interested in improving Hadoop's documentation. He starts by fixing outdated information and incorrect examples, reaching out to subject matter experts and exploring the codebase to clarify technical details. As Peter becomes more familiar with the set of documentation, he realizes that a newly contributed feature didn't include sufficient documentation, and contributes a guide on how to setup and use the feature that also explains some of the design decisions that influenced API design. Peter continues to broaden his doc contributions to more and more areas, and also is active answering user questions on the mailing list. This demonstrates his knowledge of the project, attention to detail, and also his user-focus.</p>
+</div>
+
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+        Copyright &copy;
+         2014 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+<br>
+              Apache Hadoop, Hadoop, Apache, the Apache feather logo, and the Apache
+              Hadoop project logo are either registered trademarks or trademarks of
+              the Apache Software Foundation in the United States and other
+              countries.
+            </div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Added: hadoop/common/site/main/publish/committer_criteria.pdf
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/committer_criteria.pdf?rev=1755112&view=auto
==============================================================================
Binary file - no diff available.

Propchange: hadoop/common/site/main/publish/committer_criteria.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Modified: hadoop/common/site/main/publish/index.html
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/index.html?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
--- hadoop/common/site/main/publish/index.html (original)
+++ hadoop/common/site/main/publish/index.html Wed Aug  3 20:40:16 2016
@@ -139,6 +139,9 @@ document.write("Last Published: " + docu
 <a href="releases.html">Releases</a>
 </div>
 <div class="menuitem">
+<a href="versioning.html">Release Versioning</a>
+</div>
+<div class="menuitem">
 <a href="mailing_lists.html">Mailing Lists</a>
 </div>
 <div class="menuitem">
@@ -166,6 +169,9 @@ document.write("Last Published: " + docu
 <a href="bylaws.html">Bylaws</a>
 </div>
 <div class="menuitem">
+<a href="committer_criteria.html">Committer criteria</a>
+</div>
+<div class="menuitem">
 <a href="http://www.apache.org/licenses/">License</a>
 </div>
 </div>

Modified: hadoop/common/site/main/publish/index.pdf
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/index.pdf?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
Binary files - no diff available.

Modified: hadoop/common/site/main/publish/issue_tracking.html
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/issue_tracking.html?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
--- hadoop/common/site/main/publish/issue_tracking.html (original)
+++ hadoop/common/site/main/publish/issue_tracking.html Wed Aug  3 20:40:16 2016
@@ -122,6 +122,9 @@ document.write("Last Published: " + docu
 <a href="releases.html">Releases</a>
 </div>
 <div class="menuitem">
+<a href="versioning.html">Release Versioning</a>
+</div>
+<div class="menuitem">
 <a href="mailing_lists.html">Mailing Lists</a>
 </div>
 <div class="menupage">
@@ -163,6 +166,9 @@ document.write("Last Published: " + docu
 <a href="bylaws.html">Bylaws</a>
 </div>
 <div class="menuitem">
+<a href="committer_criteria.html">Committer criteria</a>
+</div>
+<div class="menuitem">
 <a href="http://www.apache.org/licenses/">License</a>
 </div>
 </div>

Modified: hadoop/common/site/main/publish/issue_tracking.pdf
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/issue_tracking.pdf?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
Binary files - no diff available.

Modified: hadoop/common/site/main/publish/linkmap.html
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/linkmap.html?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
--- hadoop/common/site/main/publish/linkmap.html (original)
+++ hadoop/common/site/main/publish/linkmap.html Wed Aug  3 20:40:16 2016
@@ -122,6 +122,9 @@ document.write("Last Published: " + docu
 <a href="releases.html">Releases</a>
 </div>
 <div class="menuitem">
+<a href="versioning.html">Release Versioning</a>
+</div>
+<div class="menuitem">
 <a href="mailing_lists.html">Mailing Lists</a>
 </div>
 <div class="menuitem">
@@ -149,6 +152,9 @@ document.write("Last Published: " + docu
 <a href="bylaws.html">Bylaws</a>
 </div>
 <div class="menuitem">
+<a href="committer_criteria.html">Committer criteria</a>
+</div>
+<div class="menuitem">
 <a href="http://www.apache.org/licenses/">License</a>
 </div>
 </div>
@@ -265,6 +271,12 @@ document.write("Last Published: " + docu
     
 <ul>
 <li>
+<a href="versioning.html">Release Versioning</a>&nbsp;&nbsp;___________________&nbsp;&nbsp;<em>versioning</em>
+</li>
+</ul>
+    
+<ul>
+<li>
 <a href="mailing_lists.html">Mailing Lists</a>&nbsp;&nbsp;___________________&nbsp;&nbsp;<em>mail</em>
 </li>
 </ul>    
@@ -317,6 +329,12 @@ document.write("Last Published: " + docu
 </li>
 </ul>
     
+<ul>
+<li>
+<a href="committer_criteria.html">Committer criteria</a>&nbsp;&nbsp;___________________&nbsp;&nbsp;<em>committer</em>
+</li>
+</ul>
+    
 <ul>
 <li>
 <a href="http://www.apache.org/licenses/">License</a>&nbsp;&nbsp;___________________&nbsp;&nbsp;<em>license</em>

Modified: hadoop/common/site/main/publish/linkmap.pdf
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/linkmap.pdf?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
Binary files - no diff available.

Modified: hadoop/common/site/main/publish/mailing_lists.html
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/mailing_lists.html?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
--- hadoop/common/site/main/publish/mailing_lists.html (original)
+++ hadoop/common/site/main/publish/mailing_lists.html Wed Aug  3 20:40:16 2016
@@ -121,6 +121,9 @@ document.write("Last Published: " + docu
 <div class="menuitem">
 <a href="releases.html">Releases</a>
 </div>
+<div class="menuitem">
+<a href="versioning.html">Release Versioning</a>
+</div>
 <div class="menupage">
 <div class="menupagetitle">Mailing Lists</div>
 <div class="menupageitemgroup">
@@ -172,6 +175,9 @@ document.write("Last Published: " + docu
 <a href="bylaws.html">Bylaws</a>
 </div>
 <div class="menuitem">
+<a href="committer_criteria.html">Committer criteria</a>
+</div>
+<div class="menuitem">
 <a href="http://www.apache.org/licenses/">License</a>
 </div>
 </div>

Modified: hadoop/common/site/main/publish/mailing_lists.pdf
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/mailing_lists.pdf?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
Binary files - no diff available.

Modified: hadoop/common/site/main/publish/privacy_policy.html
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/privacy_policy.html?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
--- hadoop/common/site/main/publish/privacy_policy.html (original)
+++ hadoop/common/site/main/publish/privacy_policy.html Wed Aug  3 20:40:16 2016
@@ -122,6 +122,9 @@ document.write("Last Published: " + docu
 <a href="releases.html">Releases</a>
 </div>
 <div class="menuitem">
+<a href="versioning.html">Release Versioning</a>
+</div>
+<div class="menuitem">
 <a href="mailing_lists.html">Mailing Lists</a>
 </div>
 <div class="menuitem">
@@ -154,6 +157,9 @@ document.write("Last Published: " + docu
 <a href="bylaws.html">Bylaws</a>
 </div>
 <div class="menuitem">
+<a href="committer_criteria.html">Committer criteria</a>
+</div>
+<div class="menuitem">
 <a href="http://www.apache.org/licenses/">License</a>
 </div>
 </div>

Modified: hadoop/common/site/main/publish/privacy_policy.pdf
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/privacy_policy.pdf?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
Binary files - no diff available.

Modified: hadoop/common/site/main/publish/releases.html
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/releases.html?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
--- hadoop/common/site/main/publish/releases.html (original)
+++ hadoop/common/site/main/publish/releases.html Wed Aug  3 20:40:16 2016
@@ -130,6 +130,9 @@ document.write("Last Published: " + docu
 </div>
 </div>
 <div class="menuitem">
+<a href="versioning.html">Release Versioning</a>
+</div>
+<div class="menuitem">
 <a href="mailing_lists.html">Mailing Lists</a>
 </div>
 <div class="menuitem">
@@ -157,6 +160,9 @@ document.write("Last Published: " + docu
 <a href="bylaws.html">Bylaws</a>
 </div>
 <div class="menuitem">
+<a href="committer_criteria.html">Committer criteria</a>
+</div>
+<div class="menuitem">
 <a href="http://www.apache.org/licenses/">License</a>
 </div>
 </div>

Modified: hadoop/common/site/main/publish/releases.pdf
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/releases.pdf?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
Binary files - no diff available.

Modified: hadoop/common/site/main/publish/version_control.html
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/version_control.html?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
--- hadoop/common/site/main/publish/version_control.html (original)
+++ hadoop/common/site/main/publish/version_control.html Wed Aug  3 20:40:16 2016
@@ -122,6 +122,9 @@ document.write("Last Published: " + docu
 <a href="releases.html">Releases</a>
 </div>
 <div class="menuitem">
+<a href="versioning.html">Release Versioning</a>
+</div>
+<div class="menuitem">
 <a href="mailing_lists.html">Mailing Lists</a>
 </div>
 <div class="menuitem">
@@ -149,6 +152,9 @@ document.write("Last Published: " + docu
 <a href="bylaws.html">Bylaws</a>
 </div>
 <div class="menuitem">
+<a href="committer_criteria.html">Committer criteria</a>
+</div>
+<div class="menuitem">
 <a href="http://www.apache.org/licenses/">License</a>
 </div>
 </div>

Modified: hadoop/common/site/main/publish/version_control.pdf
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/version_control.pdf?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
Binary files - no diff available.

Added: hadoop/common/site/main/publish/versioning.html
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/versioning.html?rev=1755112&view=auto
==============================================================================
--- hadoop/common/site/main/publish/versioning.html (added)
+++ hadoop/common/site/main/publish/versioning.html Wed Aug  3 20:40:16 2016
@@ -0,0 +1,359 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.9">
+<meta name="Forrest-skin-name" content="hadoop-pelt">
+<title>Apache Hadoop Release Versioning</title>
+<link type="text/css" href="skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="skin/print.css" rel="stylesheet">
+<link type="text/css" href="skin/profile.css" rel="stylesheet">
+<script src="skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="images/favicon.ico">
+<script type="text/javascript">
+
+  var _gaq = _gaq || [];
+  _gaq.push(['_setAccount', 'UA-7453027-1']);
+  _gaq.push(['_setDomainName', 'apache.org']);
+  _gaq.push(['_trackPageview']);
+
+  (function() {
+    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+  })();
+
+        </script>
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://hadoop.apache.org/">Hadoop</a><script src="skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+    |header
+    +-->
+<div class="header">
+<!--+
+    |start group logo
+    +-->
+<div class="grouplogo">
+<a href="http://www.apache.org"><img class="logoImage" alt="Apache" src="images/apache_feather.gif" title="Apache Software Foundation"></a>
+</div>
+<!--+
+    |end group logo
+    +-->
+<!--+
+    |start Project Logo
+    +-->
+<div class="projectlogo">
+<a href="http://hadoop.apache.org/"><img class="logoImage" alt="Hadoop" src="images/hadoop-logo.jpg" title="Scalable Distributed Computing"></a>
+</div>
+<!--+
+    |end Project Logo
+    +-->
+<!--+
+    |start Search
+    +-->
+<div class="searchbox">
+<form action="http://search-hadoop.com/" method="get">
+<input onFocus="getBlank (this, 'Search with Apache Solr');" size="25" name="q" id="query" type="text" value="Search with Apache Solr">&nbsp;
+		  <input value="Search" type="submit">
+</form>
+</div>
+<!--+
+    |end search
+    +-->
+<!--+
+    |start Tabs
+    +-->
+<ul id="tabs">
+<li class="current">
+<a class="selected" href="index.html">Top</a>
+</li>
+<li>
+<a class="unselected" href="http://wiki.apache.org/hadoop">Wiki</a>
+</li>
+</ul>
+<!--+
+    |end Tabs
+    +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+    |start Subtabs
+    +-->
+<div id="level2tabs"></div>
+<!--+
+    |end Endtabs
+    +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<!--+
+    |breadtrail
+    +-->
+<div class="breadtrail">
+
+             &nbsp;
+           </div>
+<!--+
+    |start Menu, mainarea
+    +-->
+<!--+
+    |start Menu
+    +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', 'skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">About</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="index.html">Welcome</a>
+</div>
+<div class="menuitem">
+<a href="releases.html">Releases</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Release Versioning</div>
+<div class="menupageitemgroup">
+<div class="menupageitem">
+<a href="#Background">Background</a>
+</div>
+<div class="menupageitem">
+<a title="Versioning rules" href="#Versioning+rules">Versioning rules...</a>
+</div>
+<div class="menupageitem">
+<a href="#Example">Example</a>
+</div>
+</div>
+</div>
+<div class="menuitem">
+<a href="mailing_lists.html">Mailing Lists</a>
+</div>
+<div class="menuitem">
+<a href="issue_tracking.html">Issue Tracking</a>
+</div>
+<div class="menuitem">
+<a href="who.html">Who We Are?</a>
+</div>
+<div class="menuitem">
+<a href="http://wiki.apache.org/hadoop/PoweredBy">Who Uses Hadoop?</a>
+</div>
+<div class="menuitem">
+<a href="http://www.cafepress.com/hadoop/">Buy Stuff</a>
+</div>
+<div class="menuitem">
+<a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a>
+</div>
+<div class="menuitem">
+<a href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+</div>
+<div class="menuitem">
+<a href="privacy_policy.html">Privacy Policy</a>
+</div>
+<div class="menuitem">
+<a href="bylaws.html">Bylaws</a>
+</div>
+<div class="menuitem">
+<a href="committer_criteria.html">Committer criteria</a>
+</div>
+<div class="menuitem">
+<a href="http://www.apache.org/licenses/">License</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.2', 'skin/')" id="menu_1.2Title" class="menutitle">Documentation</div>
+<div id="menu_1.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/current/">Current</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/stable/">Stable</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/r1.2.1/">Release 1.2.1</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/r2.5.2/">Release 2.5.2</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/r2.6.4/">Release 2.6.4</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/r0.23.11/">Release 0.23.11</a>
+</div>
+<div class="menuitem">
+<a href="http://hadoop.apache.org/docs/r2.7.2/">Release 2.7.2</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.3', 'skin/')" id="menu_1.3Title" class="menutitle">Related Projects</div>
+<div id="menu_1.3" class="menuitemgroup">
+<div class="menuitem">
+<a href="http://incubator.apache.org/ambari/">Ambari</a>
+</div>
+<div class="menuitem">
+<a href="http://avro.apache.org/">Avro</a>
+</div>
+<div class="menuitem">
+<a href="http://cassandra.apache.org/">Cassandra</a>
+</div>
+<div class="menuitem">
+<a href="http://incubator.apache.org/chukwa/">Chukwa</a>
+</div>
+<div class="menuitem">
+<a href="http://incubator.apache.org/hama/">Hama</a>
+</div>
+<div class="menuitem">
+<a href="http://hbase.apache.org/">HBase</a>
+</div>
+<div class="menuitem">
+<a href="http://hive.apache.org/">Hive</a>
+</div>
+<div class="menuitem">
+<a href="http://mahout.apache.org/">Mahout</a>
+</div>
+<div class="menuitem">
+<a href="http://pig.apache.org/">Pig</a>
+</div>
+<div class="menuitem">
+<a href="http://spark.incubator.apache.org/">Spark</a>
+</div>
+<div class="menuitem">
+<a href="http://tez.incubator.apache.org/">Tez</a>
+</div>
+<div class="menuitem">
+<a href="http://zookeeper.apache.org/">ZooKeeper</a>
+</div>
+</div>
+<div id="credit"></div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+  |alternative credits
+  +-->
+<div id="credit2"></div>
+</div>
+<!--+
+    |end Menu
+    +-->
+<!--+
+    |start content
+    +-->
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="versioning.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
+        PDF</a>
+</div>
+<h1>Apache Hadoop Release Versioning</h1> 
+
+      
+<a name="N1000D"></a><a name="Background"></a>
+<h2 class="h3">Background</h2>
+<div class="section">
+<p>Apache Hadoop uses a version format of <strong>&lt;major&gt;.&lt;minor&gt;.&lt;maintenance&gt;</strong>, where each version component is a numeric value. Versions can also have additional suffixes like <em>"-alpha2"</em> or <em>"-beta1"</em>, which denote the API compatibility guarantees and quality of the release. We use <em>"a.b.c"</em> and <em>"x.y.z"</em> to denote a dotted version triplet.</p>
+<p>Major versions are used to introduce substantial, potentially incompatible, changes. Examples of this include the replacement of MapReduce 1 with YARN and MapReduce 2 in Hadoop 2, and the required Java runtime version from JDK7 to JDK8 in Hadoop 3.</p>
+<p>Minor versions are used to introduce new compatible features within a major release line.</p>
+<p>Maintenance releases include bug fixes or low-risk supportability changes.</p>
+<p>Hadoop's versioning scheme has evolved over the years. The early days of 0.20.2 leading up to the 1.y releases saw a <a href="http://blog.cloudera.com/blog/2012/01/an-update-on-apache-hadoop-1-0/">plethora of parallel releases</a> with different featuresets. Release activities coalesced in the early 2.y release era, with a mostly linear progression of releases from 2.0.0 through 2.7.0.</p>
+<p>However, the ongoing maintenance of the 2.6.z and 2.7.z re-introduced parallel active release lines to Hadoop. Additional plans for 2.8.z and 3.0.z releases mean potentially four active release lines, necessitating clarification on Hadoop versioning and how it affects these parallel release branches.</p>
+</div>
+
+      
+<a name="N10038"></a><a name="Versioning+rules"></a>
+<h2 class="h3">Versioning rules</h2>
+<div class="section">
+<p>To establish a common foundation of knowledge, we require the following in terms of release versions.</p>
+<ul>
+              
+<li>For <strong>a.b.c </strong>(maintenance) releases, the "c"s need to be released in order.</li>
+              
+<li>For <strong>a.b.0</strong> (minor) releases, the "b"s need to be released in order.</li>
+                
+<li>For <strong>a.0.0</strong> (major) releases, it comes after a specific x.y.0 minor release.</li>
+          
+</ul>
+<p>This means that new major releases need to be coordinated with the previous minor release. New minor and maintenance releases only require coordination within their release line.</p>
+<p>
+<em>"-alphaX"</em> and <em>"-betaX"</em> suffixed version can be treated as a.b.c versions, with the first (e.g. <em>"-alpha1"</em>) being the a.b.0 release.</p>
+<p>When it comes to setting fix versions, this policy is encoded by the following set of rules:</p>
+<ol>
+            
+<li>For each <strong>minor</strong> release line, set the <strong>lowest unreleased a.b.c version, where c &ge; 0</strong>.</li>
+              
+<li>For each <strong>major</strong> release line, set the <strong>lowest unreleased a.b.0 version</strong>.</li>
+          
+</ol>
+</div>
+      
+<a name="N1007C"></a><a name="Example"></a>
+<h2 class="h3">Example</h2>
+<div class="section">
+<p>As an example, as of August 3rd, 2016, the latest releases in the 2.6.x and 2.7.x lines are 2.6.4 and 2.7.2. We have also cut the following branches for planned future releases: branch-2.7.3, branch-2.8, and branch-3.0.0-alpha1.</p>
+<p>If we are committing a bugfix that is intended for the 2.6.5 release, we would commit to:</p>
+<ol>
+              
+<li>trunk (3.0.0-alpha2)</li>
+              
+<li>branch-3.0.0-alpha1 (3.0.0-alpha1)</li>
+              
+<li>branch-2 (2.9.0)</li>
+              
+<li>branch-2.8 (2.8.0)</li>
+              
+<li>branch-2.7 (2.7.4)</li>
+              
+<li>branch-2.7.3 (2.7.3)</li>
+              
+<li>branch-2.6 (2.6.5)</li>
+          
+</ol>
+<p>Applying the above rules for setting fix versions:</p>
+<ol>
+              
+<li>Rule 1: 2.6.z and 2.7.z are both minor release lines, so set <strong>2.6.5</strong> and <strong>2.7.3</strong>
+</li>
+              
+<li>Rule 2: 2.y.z and 3.y.z the major release lines, so set <strong>2.8.0</strong> and <strong>3.0.0-alpha1</strong>
+</li>
+          
+</ol>
+<p>Note that when backporting changes, we always make sure to backport to the next higher release in a release line. For instance, we make sure to backport to branch-2.7 (2.7.4) when backporting to branch-2.7.3 (2.7.3), and to branch-2 (2.9.0) when backporting to branch-2.8 (2.8.0). This preserves the monotonicity of releases.</p>
+</div>
+  
+</div>
+<!--+
+    |end content
+    +-->
+<div class="clearboth">&nbsp;</div>
+</div>
+<div id="footer">
+<!--+
+    |start bottomstrip
+    +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+//  --></script>
+</div>
+<div class="copyright">
+        Copyright &copy;
+         2014 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+<br>
+              Apache Hadoop, Hadoop, Apache, the Apache feather logo, and the Apache
+              Hadoop project logo are either registered trademarks or trademarks of
+              the Apache Software Foundation in the United States and other
+              countries.
+            </div>
+<!--+
+    |end bottomstrip
+    +-->
+</div>
+</body>
+</html>

Added: hadoop/common/site/main/publish/versioning.pdf
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/versioning.pdf?rev=1755112&view=auto
==============================================================================
Binary file - no diff available.

Propchange: hadoop/common/site/main/publish/versioning.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Modified: hadoop/common/site/main/publish/who.html
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/who.html?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
--- hadoop/common/site/main/publish/who.html (original)
+++ hadoop/common/site/main/publish/who.html Wed Aug  3 20:40:16 2016
@@ -122,6 +122,9 @@ document.write("Last Published: " + docu
 <a href="releases.html">Releases</a>
 </div>
 <div class="menuitem">
+<a href="versioning.html">Release Versioning</a>
+</div>
+<div class="menuitem">
 <a href="mailing_lists.html">Mailing Lists</a>
 </div>
 <div class="menuitem">
@@ -166,6 +169,9 @@ document.write("Last Published: " + docu
 <a href="bylaws.html">Bylaws</a>
 </div>
 <div class="menuitem">
+<a href="committer_criteria.html">Committer criteria</a>
+</div>
+<div class="menuitem">
 <a href="http://www.apache.org/licenses/">License</a>
 </div>
 </div>

Modified: hadoop/common/site/main/publish/who.pdf
URL: http://svn.apache.org/viewvc/hadoop/common/site/main/publish/who.pdf?rev=1755112&r1=1755111&r2=1755112&view=diff
==============================================================================
Binary files - no diff available.



---------------------------------------------------------------------
To unsubscribe, e-mail: common-commits-unsubscribe@hadoop.apache.org
For additional commands, e-mail: common-commits-help@hadoop.apache.org


Mime
View raw message