incubator-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From git-site-r...@apache.org
Subject [1/2] incubator git commit: Automatic Site Publish by Buildbot
Date Sat, 24 Jun 2017 14:14:39 GMT
Repository: incubator
Updated Branches:
  refs/heads/asf-site 6f166c2ac -> d694ae5b0


http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/mentor.html
----------------------------------------------------------------------
diff --git a/guides/mentor.html b/guides/mentor.html
new file mode 100644
index 0000000..294040a
--- /dev/null
+++ b/guides/mentor.html
@@ -0,0 +1,486 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8"/>
+    <title>Mentors' Guide</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="description" content="">
+    <meta name="author" content="">
+    <meta name="keywords" content="">
+    <meta name="generator" content="JBake">
+
+    <!-- Le styles -->
+    <link href="../css/incubator.css" rel="stylesheet">
+    <link href="../css/bootstrap.css" rel="stylesheet">
+    <link href="../css/asciidoctor.css" rel="stylesheet">
+    <link href="../css/base.css" rel="stylesheet">
+    <link href="../css/prettify.css" rel="stylesheet">
+
+    <!-- HTML5 shim, for IE6-8 support of HTML5 elements -->
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+
+    <!-- Fav and touch icons -->
+    <!--<link rel="apple-touch-icon-precomposed" sizes="144x144" href="../assets/ico/apple-touch-icon-144-precomposed.png">
+    <link rel="apple-touch-icon-precomposed" sizes="114x114" href="../assets/ico/apple-touch-icon-114-precomposed.png">
+    <link rel="apple-touch-icon-precomposed" sizes="72x72" href="../assets/ico/apple-touch-icon-72-precomposed.png">
+    <link rel="apple-touch-icon-precomposed" href="../assets/ico/apple-touch-icon-57-precomposed.png">-->
+    <link rel="shortcut icon" href="https://www.apache.org/favicon.ico">
+  </head>
+  <body onload="prettyPrint()">
+    <div id="wrap">
+   
+
+	<!-- Fixed navbar -->
+    <div class="navbar navbar-default navbar-fixed-top" role="navigation">
+      <div class="container">
+        <div class="navbar-header">
+          <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
+            <span class="sr-only">Toggle navigation</span>
+            <span class="icon-bar"></span>
+            <span class="icon-bar"></span>
+            <span class="icon-bar"></span>
+          </button>
+          <a class="navbar-brand" href="https://incubator.apache.org/ngtest"><i class="icon-home"></i>Apache Incubator</a>
+        </div>
+        <div class="navbar-collapse collapse">
+          <ul class="nav navbar-nav">
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Policies <b class="caret"></b></a>
+              <ul class="dropdown-menu">
+                
+                  <li><a href="https://incubator.apache.org/ngtest/policy/incubation.html">Incubation Policy</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/policy/process.html">Incubation Process</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/policy/roles_and_responsibilities.html">Roles and Responsibilities</a></li>
+                
+              </ul>
+            </li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Proposals <b class="caret"></b></a>
+              <ul class="dropdown-menu">
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/proposal.html">A Guide To Proposal Creation</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/podling-story.html">The Story of a Podling</a></li>
+                
+              </ul>
+            </li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Podling Guides <b class="caret"></b></a>
+              <ul class="dropdown-menu">
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/about.html">About IPMC</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/branding.html">Incubator Branding Guide</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/committer.html">Committers</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/community.html">Guide to Successful Community Building</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/entry.html">Enter The Incubator</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/graduation.html">Guide to Successful Graduation</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/ip_clearance.html">IP Clearance</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/names.html">Podling Name Search Guide</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/podling_sourcecontrol.html">Podling Source Control</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/ppmc.html">Apache Incubator: Podling Project Management Committee</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/press-kit.html">Podling Press Kit</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/releasemanagement.html">Release Management</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/retirement.html">Guide to Retirement</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
+                <li><a href="/clutch">Clutch Report</a></li>
+              </ul>
+            </li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">PMC Guides <b class="caret"></b></a>
+              <ul class="dropdown-menu">
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/chair.html">Incubator Chair Guide</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/lists.html">Incubator Mailing Lists Guide</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/mentor.html">Mentors' Guide</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/participation.html">Guide to Participation</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/pmc.html">The Incubator PMC</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/website.html">Updating the top-level Incubator website</a></li>
+                
+              </ul>
+            </li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a>
+              <ul class="dropdown-menu">
+                <li><a href="http://www.apache.org/foundation/how-it-works.html">How Apache Works</a></li>
+                <li><a href="http://www.apache.org/dev/">Developer Documentation</a></li>
+                <li><a href="http://www.apache.org/foundation/">Foundation</a></li>
+                <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsor Apache</a></li>
+                <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+              </ul>
+            </li>
+          </ul>
+        </div><!--/.nav-collapse -->
+      </div>
+    </div>
+    <div class="container">
+      <div class="row">
+        <div class="col-md-4 vcenter"><a href="https://www.apache.org/"><img src="http://www.apache.org/img/asf_logo.png" alt="The Apache Software Foundation" border="0" style="margin-top: 2px" width="250"></a></div>
+          <div class="col-md-4 vcenter"><a href="/"><img src="https://incubator.apache.org/images/incubator_feather_egg_logo_sm.png" alt="The Apache Software Foundation Incubator" border="0" style="margin-top: 2px" height="100"></a></div>
+          <div class="col-md-4 vcenter"><a href="https://www.apache.org/foundation/contributing.html"><img src="https://www.apache.org/images/SupportApache-small.png" height="75" width="75"></a></div>
+      </div>
+    </div>
+    <div class="top-container container">
+
+<div class="page-header">
+    <h1>Guide :: Mentors' Guide</h1>
+</div>
+
+<div class="article-body">
+
+Estimated Reading Time: <span class="eta"></span>
+
+<p><div id="toc" class="toc">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel1">
+<li><a href="#add_to_incubation_summary_file">Add to Incubation Summary file</a></li>
+<li><a href="#initialize_podling_status_page">Initialize Podling Status Page</a>
+<ul class="sectlevel2">
+<li><a href="#request_required_resources">Request Required Resources</a></li>
+<li><a href="#draft_podling_bootstrap">[DRAFT] Podling Bootstrap</a></li>
+<li><a href="#mentors_must_be_on_the_ipmc">Mentors MUST be on the IPMC</a></li>
+<li><a href="#cla_and_ccla_submission">CLA and CCLA Submission</a></li>
+</ul>
+</li>
+</ul>
+</div>
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>The Mentors' guide is a go-to place for information about getting a podling up and running from an infrastructure point of view.</p>
+</div>
+<div class="paragraph">
+<p>This document targets any Incubating Project member, but
+especially Mentors, who have to ensure that some things get done.
+For a general description of the role of a mentor on an incubating
+project see the
+<a href="/policy/roles_and_responsibilities.html#Mentor">Roles and Responsibilities</a>document.</p>
+</div>
+<div class="paragraph">
+<p>This guide is a descriptive and at times
+discursive document. It describes established practices.
+It is informational not normative. Policy is laid down in the
+<a href="/incubation/Incubation_Policy.html">Incubation Policy</a>.
+== Overview</p>
+</div>
+<div class="paragraph">
+<p>After the Podling has been accepted by the Incubator PMC, one of the mentors
+<a href="/incubation/Incubation_Policy.html#Setting+Up+a+New+Podling">sets up</a>
+the Podling; <em>i.e.</em> adds the podling metadata, creates the initial Podling status page, and
+either creates or requests that
+other resources (mail lists, subversion, bug tracker, <em>etc.</em>)
+be created.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="add_to_incubation_summary_file">Add to Incubation Summary file</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Add the podling to the podling summary file in
+the "incubator" SVN at <strong>content/podlings.xml</strong>
+(e.g. copy the entry from another podling that also has status="current")
+and see <a href="website.html">instructions</a>.</p>
+</div>
+<div class="paragraph">
+<p>Please do this step ASAP after Acceptance. Other setup procedures utilize
+this metadata.</p>
+</div>
+<div class="paragraph">
+<p>Add a <strong>'reporting'</strong> tag (after <strong>'description'</strong>) with the attribute <strong>'monthly="true"'</strong>
+and the appropriate "group" attribute, based on the month in which  the podling
+entered incubation (1 for January, April, July, October, 2 for February, May,
+August, November or 3 for March, June, September, December). The text content
+of the 'reporting' tag must contain the initial list of reporting months,
+starting with the month after the podling entered incubation.  Below is an example of the final XML snippet</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>    &lt;podling name="PodlingName" status="current" resource="podlingname" sponsor="Sponsor" startdate="YYYY-MM-DD"&gt;
+        &lt;description&gt;A description of the podling, for the status page and reports&lt;/description&gt;
+        &lt;reporting group="1|2|3" monthly="true"&gt;First,Second,Third&lt;/reporting&gt;
+        &lt;champion availid="userid"&gt;Champion Name&lt;/champion&gt;
+        &lt;mentors&gt;
+            &lt;mentor username="userid"&gt;Mentor One&lt;/mentor&gt;
+            &lt;mentor username="userid"&gt;Mentor Two&lt;/mentor&gt;
+            &lt;mentor username="userid"&gt;Mentor Three&lt;/mentor&gt;
+        &lt;/mentors&gt;
+    &lt;/podling&gt;</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>An example reporting block:</p>
+</div>
+<div class="literalblock">
+<div class="content">
+<pre>&lt;reporting group="3" monthly="true"&gt;June, July, August&lt;/reporting&gt;</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Once the first three reports are complete, the monthly attribute should be removed
+and the list of months removed as well.</p>
+</div>
+<div class="paragraph">
+<p>The first report might be
+very short. However it is better that the Incubator PMC can help to
+guide through the early setup stages.
+For more details see the
+<a href="ppmc.html#Incubator+ASF+Board+Reports">PPMC Guide</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="initialize_podling_status_page">Initialize Podling Status Page</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>A mentor needs to
+<a href="website.html#Edit+your+project+status+page">create the web page</a> that will track the project&#8217;s status.
+A mentor will also need to update it until
+<a href="ppmc.html#Project+Status+Updates">others in the project&#8217;s PPMC can update it</a>.</p>
+</div>
+<div class="paragraph">
+<p>The status
+page is the incubator&#8217;s record of the progress made.
+It MUST be kept update to date during incubation.
+Some of the information is available from the proposal.
+As the startup process continues and resources are
+created the status SHOULD be updated.</p>
+</div>
+<div class="paragraph">
+<p>The template contains lists of actions which may be needed
+to start up a podling. All those which do not apply should
+be deleted.</p>
+</div>
+<div class="paragraph">
+<p>The status page is a useful aid to workflow. Volunteers
+can use it to sign up to the various tasks and monitor their
+progress. Once the mailing lists are set up and prospective
+committers subscribe then these may be used for discussion.</p>
+</div>
+<div class="sect2">
+<h3 id="request_required_resources">Request Required Resources</h3>
+<div class="paragraph">
+<p>The proposal should include a list of required resources. All of these will
+require active set up. Some are created by infrastructure after an appropriate
+request, others can be set up by any IPMC members (typically mentors).</p>
+</div>
+<div class="paragraph">
+<p>Mailing lists should be created first. Other resources typically
+post information to these lists.</p>
+</div>
+<div class="sect3">
+<h4 id="request_mailing_lists">Request Mailing Lists</h4>
+<div class="paragraph">
+<p>Apache mailing lists require volunteer moderators. New moderators can be
+<a href="http://www.apache.org/dev/committers.html#mailing-list-moderators">changed later</a>
+but at least one volunteer is required before the mailing lists can be set up.
+Moderation is a reasonably
+<a href="http://www.apache.org/dev/committers.html#mail-moderate">easy task</a>
+though moderators may want to set up
+<a href="http://spamassassin.apache.org/">spam filtering</a>.
+Having at least three moderators is recommended to spread the load.</p>
+</div>
+<div class="paragraph">
+<p>The proposal should contain the rest of the information that needs to be collected
+before the mailing lists can be requested. Incubator is the responsible top level project.
+So the domain <strong>MUST</strong> be <strong>incubator.apache.org</strong>.
+For example:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>dev@${podling}.incubator.apache.org</p>
+</li>
+<li>
+<p>commits@${podling}.incubator.apache.org</p>
+</li>
+<li>
+<p>private@${podling}.incubator.apache.org</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>For initial community building it is usually appropriate to only have
+a "dev" list, to keep the discussions focussed. Later add a "user" list
+if needed.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Commits under *http://svn.apache.org/repos/asf/incubator/_${podling}_*
+will be emailed to *commits@${podling}.incubator.apache.org*.
+Any deviation will
+require special configuration in the *asf-mailer.conf* file by the IPMC.</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Mailing lists creation is a task for the <a href="#who-infra">infrastructure team</a>. The
+infrastructure team offers a tool that simplifies the creation of mailing lists.  You can access the
+link:https://infra.apache.org/officers/mlreq/incubator" target="_new[Incubator Mailing List Request Form]
+to request a list.  A notification will be sent to private@incubator when the lists have been created.</p>
+</div>
+<div class="paragraph">
+<p>Remember to update the project status file with mailing list details. Prospective committers
+and mentors will need to subscribe. Email them once the status file has been updated. Inform
+any existing mailing lists or forums previously used by the project.</p>
+</div>
+<div class="paragraph">
+<p>Once the <strong>commits</strong> list is created, the project MUST review
+the <strong>/incubator/${podling}</strong> tree, since any commits made prior
+to the list&#8217;s creation will have generated no email trail.</p>
+</div>
+<div class="sect4">
+<h5 id="mail_archives">Mail Archives</h5>
+<div class="paragraph">
+<p>Archives at <a href="http://mail-archives.apache.org">http://mail-archives.apache.org</a> for the public
+mailing lists will be setup as part of the mailing list creation process. No action is
+required by Mentors. The archives will be <a href="http://mail-archives.apache.org/mod_mbox/">visible</a>
+as soon as posts have been made (and moderated) to these lists.</p>
+</div>
+<div class="paragraph">
+<p>You can also leverage link:https://lists.apache.org" target="_new[lists.apache.org] for
+mailing list archives.  There is a login link in the top right corner, which allows you to respond to
+threads from within the web application.</p>
+</div>
+<div class="paragraph">
+<p>Many projects are independently archived externally (for example, at
+<a href="http://www.mail-archive.com/">The Mail Archive</a> and
+<a href="http://marc.info/?q=about">MARC</a>)
+Independent archives help to
+increase project visibility as well as preserving a independent historic record.
+These subscriptions are not automatically created. If desired, subscribe manually.</p>
+</div>
+<div class="paragraph">
+<p>Subscriptions to news-to-mailing-list bridges (for example, <a href="http://www.nabble.com">Nabble</a>)
+must also be created manually. Subscribing helps accessibility and visibility but Nabble news
+users may not be aware that they are posting to a mailing list.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="mailing_list_administration">Mailing List Administration</h5>
+<div class="paragraph">
+<p>Apache uses <a href="http://www.ezmlm.org/">ezmlm</a>. See the
+<a href="http://www.ezmlm.org/man/ezmlmman.html">manual</a> and
+committer <a href="http://www.apache.org/dev/committers.html#mail">mail FAQ</a>
+for more details.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="mailing_list_transition">Mailing List Transition</h5>
+<div class="paragraph">
+<p>Independent mailing lists and groups are perfectly acceptable but development should
+happen on the official mailing lists at Apache. If a project has existing mailing lists,
+forums or groups the community needs to consider their future and plan for the transition
+to the official Apache mailing lists.</p>
+</div>
+<div class="paragraph">
+<p>It may be useful to move development first to the official lists followed gradually
+by the user resources.</p>
+</div>
+<div class="paragraph">
+<p>Note that subscribers of external mailing lists will not be automatically subscribed
+to the new Incubator project mailing lists. Instead, a note should be posted to the
+old external mailing list asking them to subscribe to the new list. If possible, add
+a footer to the old mailing list with some instructions.</p>
+</div>
+</div>
+<div class="sect4">
+<h5 id="issue_tracking">Issue Tracking</h5>
+<div class="paragraph">
+<p>Request an issue tracker on the <a href="https://issues.apache.org/jira/servicedesk/customer/portal/1/group/7">infra service desk</a></p>
+</div>
+<div class="paragraph">
+<p>Remember to post an email announcing that the issue tracker is available.</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="draft_podling_bootstrap">[DRAFT] Podling Bootstrap</h3>
+<div class="paragraph">
+<p><strong>NOTE</strong> This section is a DRAFT under development.</p>
+</div>
+<div class="paragraph">
+<p>Following podling creation, it needs to be bootstrapped. Here are some of
+the tasks:
+- Ensure <a href="#mentors-ipmc">Mentors are on the IPMC</a>[<strong>Mentors</strong>]
+- Add podling to <a href="#Sending+in+an+Incubation+Report">reporting schedule</a> [<strong>IPMC member</strong>]
+- <a href="#Initialize+Podling+Status+Page">Initialize project status page</a> [<strong>IPMC member</strong>]
+- Start <a href="#orientation">orientation</a> <strong class="*<a href="#who-committers">Prospective committers"></a>
+- Start *CLA</strong> and <strong>CCLA</strong> submission <strong class="*<a href="#who-committers">Prospective committers"></a>
+- Start <a href="#initial-ip-clearance">IP Clearance</a> [*IPMC member</strong>]
+- Request Required Resources&#8201;&#8212;&#8201;<a href="#request-mailing-lists">Mailing Lists</a> [Infrastructure Team]
+--- Consider and plan <a href="#transition-mailing-lists">transition to official mailing lists</a>&#8201;&#8212;&#8201;<a href="#Set+Up+Repository">Subversion</a> [IPMC]&#8201;&#8212;&#8201;<a href="#request-issue-tracking">Issue Tracking</a> [<a href="#who-infra">Infrastructure Team</a>]
+--- Consider and plan <a href="#issue-tracking-transition">issue tracking transition</a>
+- <a href="#create-website">Create website</a> [<strong><a href="#who-committers">Prospective committers</a></strong>]&#8201;&#8212;&#8201;Consider and plan <a href="#web-site-transition">web site transition</a></p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="mentors_must_be_on_the_ipmc">Mentors MUST be on the IPMC</h3>
+<div class="paragraph">
+<p>Mentors <a href="/policy/incubation.html#Mentor">MUST</a> be on the IPMC.  This should be checked prior to beginning incubation.
+Any prospective Mentors who are not yet on the IPMC should ask to be added (by election).
+Email the application to <strong>private@incubator.apache.org</strong>.</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>This process may take a few days.</pre>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="cla_and_ccla_submission">CLA and CCLA Submission</h3>
+<div class="paragraph">
+<p>Prospective committers need to submit a Contributor License Agreement
+(<a href="http://www.apache.org/licenses/#clas">CLA</a>).
+This process can take a while so it is recommended that committers start to submit
+these as soon as the podling is accepted.</p>
+</div>
+</div>
+</div>
+</div></p>
+
+</div>
+
+		</div>
+		<div id="push"></div>
+    </div>
+    
+    <div id="footer">
+      <div class="container">
+          <p class="muted credit">&copy; 2017 The Apache Software Foundation | Licensed under the Apache License, Version 2.0.<br/>
+          Apache Incubator, Apache, the Apache feather logo, and the Apache Incubator project logo are trademarks of The Apache Software Foundation.</p>
+      </div>
+    </div>
+
+    <script src="../js/jquery-1.11.1.min.js"></script>
+    <script src="../js/bootstrap.min.js"></script>
+    <script src="../js/prettify.js"></script>
+    <script src="../js/readingTime.js"></script>
+    <script src="../js/incubator.js"></script>
+
+  </body>
+</html>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/names.html
----------------------------------------------------------------------
diff --git a/guides/names.html b/guides/names.html
index 62b1423..724616b 100644
--- a/guides/names.html
+++ b/guides/names.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/participation.html
----------------------------------------------------------------------
diff --git a/guides/participation.html b/guides/participation.html
index d839453..c3aa4ce 100644
--- a/guides/participation.html
+++ b/guides/participation.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/pmc.html
----------------------------------------------------------------------
diff --git a/guides/pmc.html b/guides/pmc.html
index 74e1e94..8b5f481 100644
--- a/guides/pmc.html
+++ b/guides/pmc.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/podling_sourcecontrol.html
----------------------------------------------------------------------
diff --git a/guides/podling_sourcecontrol.html b/guides/podling_sourcecontrol.html
index c027993..0ad75d1 100644
--- a/guides/podling_sourcecontrol.html
+++ b/guides/podling_sourcecontrol.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>
@@ -158,9 +160,11 @@ Estimated Reading Time: <span class="eta"></span>
 <li><a href="#set_up_podling_source_repository">Set Up Podling Source Repository</a>
 <ul class="sectlevel2">
 <li><a href="#set_up_git_repository">Set up GIT Repository</a></li>
-<li><a href="#authorize_committers">Authorize Committers</a></li>
+<li><a href="#set_up_svn_repository">Set Up SVN Repository</a></li>
 </ul>
 </li>
+<li><a href="#authorize_committers">Authorize Committers</a></li>
+<li><a href="#incubator_access_authorization">Incubator Access Authorization</a></li>
 </ul>
 </div>
 <div class="sect1">
@@ -185,8 +189,9 @@ exists, incubator group members gain access without further work.  Once
 the podling graduates, a dedicated ldap group will be created to manage
 access and only those members will be given access.</p>
 </div>
-<div class="sect3">
-<h4 id="set_up_svn_repository">Set Up SVN Repository</h4>
+</div>
+<div class="sect2">
+<h3 id="set_up_svn_repository">Set Up SVN Repository</h3>
 <div class="paragraph">
 <p>If the podling chooses svn, you must create the
 repository and give read/write access to the repository
@@ -245,8 +250,10 @@ is actioned.</p>
 </div>
 </div>
 </div>
-<div class="sect2">
-<h3 id="authorize_committers">Authorize Committers</h3>
+</div>
+<div class="sect1">
+<h2 id="authorize_committers">Authorize Committers</h2>
+<div class="sectionbody">
 <div class="paragraph">
 <p>The process to add committers to the podling depends on whether
 the new committer is already an Apache committer and whether
@@ -292,6 +299,30 @@ committer is already an Apache committer on another project.</p>
 </div>
 </div>
 </div>
+<div class="sect1">
+<h2 id="incubator_access_authorization">Incubator Access Authorization</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Special karma is required to authorize incubator access for committers.
+This karma is limited to:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>IPMC Members</p>
+</li>
+<li>
+<p>Secretary</p>
+</li>
+<li>
+<p>Infrastructure</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>IPMC Members should use <a href="https://whimsy.apache.org/roster/committee/incubator">Whimsy&#8217;s Roster Tool</a> to add existing commiters.</p>
+</div>
+</div>
 </div></p>
 
 </div>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/ppmc.html
----------------------------------------------------------------------
diff --git a/guides/ppmc.html b/guides/ppmc.html
index f4b06d4..bd87584 100644
--- a/guides/ppmc.html
+++ b/guides/ppmc.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/press-kit.html
----------------------------------------------------------------------
diff --git a/guides/press-kit.html b/guides/press-kit.html
index 6e40a19..eba970a 100644
--- a/guides/press-kit.html
+++ b/guides/press-kit.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/proposal.html
----------------------------------------------------------------------
diff --git a/guides/proposal.html b/guides/proposal.html
index b246541..d43260a 100644
--- a/guides/proposal.html
+++ b/guides/proposal.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/releasemanagement.html
----------------------------------------------------------------------
diff --git a/guides/releasemanagement.html b/guides/releasemanagement.html
index 003ca50..d081ffd 100644
--- a/guides/releasemanagement.html
+++ b/guides/releasemanagement.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/retirement.html
----------------------------------------------------------------------
diff --git a/guides/retirement.html b/guides/retirement.html
index f05db7e..d20cc25 100644
--- a/guides/retirement.html
+++ b/guides/retirement.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/sites.html
----------------------------------------------------------------------
diff --git a/guides/sites.html b/guides/sites.html
index 8362fea..0a15642 100644
--- a/guides/sites.html
+++ b/guides/sites.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/transitioning_asf.html
----------------------------------------------------------------------
diff --git a/guides/transitioning_asf.html b/guides/transitioning_asf.html
new file mode 100644
index 0000000..717e9ea
--- /dev/null
+++ b/guides/transitioning_asf.html
@@ -0,0 +1,393 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8"/>
+    <title>Initial Code Import</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="description" content="">
+    <meta name="author" content="">
+    <meta name="keywords" content="">
+    <meta name="generator" content="JBake">
+
+    <!-- Le styles -->
+    <link href="../css/incubator.css" rel="stylesheet">
+    <link href="../css/bootstrap.css" rel="stylesheet">
+    <link href="../css/asciidoctor.css" rel="stylesheet">
+    <link href="../css/base.css" rel="stylesheet">
+    <link href="../css/prettify.css" rel="stylesheet">
+
+    <!-- HTML5 shim, for IE6-8 support of HTML5 elements -->
+    <!--[if lt IE 9]>
+      <script src="../js/html5shiv.min.js"></script>
+    <![endif]-->
+
+    <!-- Fav and touch icons -->
+    <!--<link rel="apple-touch-icon-precomposed" sizes="144x144" href="../assets/ico/apple-touch-icon-144-precomposed.png">
+    <link rel="apple-touch-icon-precomposed" sizes="114x114" href="../assets/ico/apple-touch-icon-114-precomposed.png">
+    <link rel="apple-touch-icon-precomposed" sizes="72x72" href="../assets/ico/apple-touch-icon-72-precomposed.png">
+    <link rel="apple-touch-icon-precomposed" href="../assets/ico/apple-touch-icon-57-precomposed.png">-->
+    <link rel="shortcut icon" href="https://www.apache.org/favicon.ico">
+  </head>
+  <body onload="prettyPrint()">
+    <div id="wrap">
+   
+
+	<!-- Fixed navbar -->
+    <div class="navbar navbar-default navbar-fixed-top" role="navigation">
+      <div class="container">
+        <div class="navbar-header">
+          <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
+            <span class="sr-only">Toggle navigation</span>
+            <span class="icon-bar"></span>
+            <span class="icon-bar"></span>
+            <span class="icon-bar"></span>
+          </button>
+          <a class="navbar-brand" href="https://incubator.apache.org/ngtest"><i class="icon-home"></i>Apache Incubator</a>
+        </div>
+        <div class="navbar-collapse collapse">
+          <ul class="nav navbar-nav">
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Policies <b class="caret"></b></a>
+              <ul class="dropdown-menu">
+                
+                  <li><a href="https://incubator.apache.org/ngtest/policy/incubation.html">Incubation Policy</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/policy/process.html">Incubation Process</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/policy/roles_and_responsibilities.html">Roles and Responsibilities</a></li>
+                
+              </ul>
+            </li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Proposals <b class="caret"></b></a>
+              <ul class="dropdown-menu">
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/proposal.html">A Guide To Proposal Creation</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/podling-story.html">The Story of a Podling</a></li>
+                
+              </ul>
+            </li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Podling Guides <b class="caret"></b></a>
+              <ul class="dropdown-menu">
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/about.html">About IPMC</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/branding.html">Incubator Branding Guide</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/committer.html">Committers</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/community.html">Guide to Successful Community Building</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/entry.html">Enter The Incubator</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/graduation.html">Guide to Successful Graduation</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/ip_clearance.html">IP Clearance</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/names.html">Podling Name Search Guide</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/podling_sourcecontrol.html">Podling Source Control</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/ppmc.html">Apache Incubator: Podling Project Management Committee</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/press-kit.html">Podling Press Kit</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/releasemanagement.html">Release Management</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/retirement.html">Guide to Retirement</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
+                
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
+                <li><a href="/clutch">Clutch Report</a></li>
+              </ul>
+            </li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">PMC Guides <b class="caret"></b></a>
+              <ul class="dropdown-menu">
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/chair.html">Incubator Chair Guide</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/lists.html">Incubator Mailing Lists Guide</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/mentor.html">Mentors' Guide</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/participation.html">Guide to Participation</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/pmc.html">The Incubator PMC</a></li>
+                
+                <li><a href="https://incubator.apache.org/ngtest/guides/website.html">Updating the top-level Incubator website</a></li>
+                
+              </ul>
+            </li>
+            <li class="dropdown">
+              <a href="#" class="dropdown-toggle" data-toggle="dropdown">ASF <b class="caret"></b></a>
+              <ul class="dropdown-menu">
+                <li><a href="http://www.apache.org/foundation/how-it-works.html">How Apache Works</a></li>
+                <li><a href="http://www.apache.org/dev/">Developer Documentation</a></li>
+                <li><a href="http://www.apache.org/foundation/">Foundation</a></li>
+                <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsor Apache</a></li>
+                <li><a href="http://www.apache.org/foundation/thanks.html">Thanks</a></li>
+              </ul>
+            </li>
+          </ul>
+        </div><!--/.nav-collapse -->
+      </div>
+    </div>
+    <div class="container">
+      <div class="row">
+        <div class="col-md-4 vcenter"><a href="https://www.apache.org/"><img src="http://www.apache.org/img/asf_logo.png" alt="The Apache Software Foundation" border="0" style="margin-top: 2px" width="250"></a></div>
+          <div class="col-md-4 vcenter"><a href="/"><img src="https://incubator.apache.org/images/incubator_feather_egg_logo_sm.png" alt="The Apache Software Foundation Incubator" border="0" style="margin-top: 2px" height="100"></a></div>
+          <div class="col-md-4 vcenter"><a href="https://www.apache.org/foundation/contributing.html"><img src="https://www.apache.org/images/SupportApache-small.png" height="75" width="75"></a></div>
+      </div>
+    </div>
+    <div class="top-container container">
+
+<div class="page-header">
+    <h1>Guide :: Initial Code Import</h1>
+</div>
+
+<div class="article-body">
+
+Estimated Reading Time: <span class="eta"></span>
+
+<p><div id="toc" class="toc">
+<div id="toctitle">Table of Contents</div>
+<ul class="sectlevel2">
+<li><a href="#importing_history">Importing History</a></li>
+<li><a href="#audit_cryptography">Audit Cryptography</a></li>
+<li><a href="#initial_clean_up">Initial Clean Up</a></li>
+<li><a href="#clean_up_best_practice">Clean Up Best Practice</a></li>
+<li><a href="#on_repackaging">On Repackaging</a></li>
+<li><a href="#update_documents">Update Documents</a>
+<ul class="sectlevel2">
+<li><a href="#update_build">Update Build</a></li>
+</ul>
+</li>
+<li><a href="#issue_tracking_transition">Issue Tracking Transition</a></li>
+</ul>
+</div>
+<div id="preamble">
+<div class="sectionbody">
+<div class="paragraph">
+<p>For corporate contributions, the SGA or CCLA MUST be completed, submitted
+and received before the code is imported.</p>
+</div>
+<div class="paragraph">
+<p>For contributions composed of patches from individual contributors,
+it is safe to import the code once the major contributors (by volume)
+have completed ICLAs or SGAs.</p>
+</div>
+<div class="paragraph">
+<p>In either case, the code to be imported should be attached to a JIRA
+and then imported. It is recommended that the previous version
+control system is tagged so that the imported version is precisely known.</p>
+</div>
+<div class="paragraph">
+<p>A public record MUST be made of the code imported. If the import is not
+attached to JIRA then it MUST be committed to version control.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="importing_history">Importing History</h3>
+<div class="paragraph">
+<p>The incoming code can either be committed as a snapshot or as a complete version
+control export including history (provided that the import is available in a format
+readable by subversion).
+Importing with history allows existing open source projects who want to maintain
+older versions at Apache to easily perform source diffs and so on. Import just the
+latest code allows a clean break to be made with the past. The choice is left to
+the community of the incoming project.</p>
+</div>
+<div class="paragraph">
+<p>The infrastructure team will perform the import including
+mapping IDs but it is an operation that requires skill, time and care. In this case,
+please ask the infrastructure team politely.</p>
+</div>
+<div class="paragraph">
+<p>If you are importing from a github repository, you&#8217;ll need to add one of our infra staff members as an admin to perform a move.</p>
+</div>
+</div>
+<div class="sect1">
+<h2 id="audit_cryptography">Audit Cryptography</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Before the code base is committed into an Apache repository, the contribution
+<a href="http://www.apache.org/dev/crypto.html">MUST</a> be checked
+and any restricted cryptography reported appropriately. Read and follow
+<a href="http://www.apache.org/dev/crypto.html">this guide</a>.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="initial_clean_up">Initial Clean Up</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Once a JIRA has been created, the source should be cleaned up.</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p>Ensure source files use the standard Apache boilerplates. This may mean replacing existing license headers. The tools in <a href="https://svn.apache.org/repos/private/committers/tools">private/committers/tools</a> and <a href="https://svn.apache.org/repos/private/committers/relicense">private/committers/relicense</a> may be useful.</p>
+</li>
+<li>
+<p>Ensure that NOTICE and LICENSE documents are present and correct.  Mentors should assist with this.</p>
+</li>
+<li>
+<p>Add any required notices. Consider moving copyright attributions from source documents to the NOTICE. Read <a href="http://www.apache.org/legal/src-headers.html">Apache policy on headers</a>.</p>
+</li>
+<li>
+<p>Audit the source for any potential licensing issues. Any which are found should either resolved immediately (when required) or noted in the status document for later.</p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>It is recommended that the initial clean up be is started
+before the code is committed. It MUST be completed before any
+releases are cut.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="clean_up_best_practice">Clean Up Best Practice</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>It is recommended that version control is used to create a
+public record of the process. This will assist anyone
+auditing the code provenance (now or in the future) to
+easily perform due diligence without contacting the people
+who performed the clean up. The clean up process should
+therefore clearly document (using version control) the
+evolution of the IP licensing.</p>
+</div>
+<div class="paragraph">
+<p>Particular care needs to be taken with commit messages
+during clean up. The intended audience needs to include
+lawyers and code auditors. Members of the public need to be
+able to follow and understand the process from these
+messages alone.</p>
+</div>
+<div class="paragraph">
+<p>It is therefore recommended that the initial source is
+(after being expanded from the archive) checked in as is
+into a special directory (<strong>${project}/trunk/import</strong> is suggested). The original packaging, copyright statements
+and license notices should be preserved. A standard Apache
+LICENSE and appropriate NOTICE should be added at the top
+for the copyright for the collective work (see <a href="http://www.apache.org/legal/src-headers.html">policy</a>). Take particular care with this commit message. As with
+any patch that contains code which is not the original work
+of the committer, the JIRA url (for the artifact imported)
+needs to be included together with notes about the original
+copyright owner and any associated paperwork. The fact that
+this is a exact import including original headers should be
+noted to stop any queries about these foreign headers.</p>
+</div>
+<div class="paragraph">
+<p>The cleanup should then proceed in a number of commits. If
+the source provenance is complex, break the process up into
+a number of logical steps committing each in turn with a
+good message.</p>
+</div>
+<div class="paragraph">
+<p>In particular, take care when relocating copyright
+statements and license notices into the NOTICE in the root
+directory: consider moving each copyright owner individually
+so that it is easier to audit. (See <a href="http://www.apache.org/legal/src-headers.html#notice">policy</a>.)</p>
+</div>
+<div class="paragraph">
+<p>Once a section of code has been cleaned up
+(and <a href="#repackaging">repackaged</a>, if necessary) normal development can begin.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="on_repackaging">On Repackaging</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>It is recommended - but not mandated - that source is repackaged
+under the Apache namespace. There is no need to use the incubator
+namespace. For example, Java source might be repackaged to
+<strong>org.apache.foo.Bar</strong> or a DTD to <strong><a href="http://podling.apache.org/foo/bar" class="bare">http://podling.apache.org/foo/bar</a></strong>.</p>
+</div>
+<div class="paragraph">
+<p>Existing open source projects moving to Apache may well need to consider
+carefully how they will approach this transition.</p>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="update_documents">Update Documents</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Check the documentation for references to the old home of the project and update them
+with references to Apache.</p>
+</div>
+<div class="paragraph">
+<p>Read
+<a href="http://incubator.apache.org/guides/branding.html">Branding Guide</a>.
+Ensure that appropriate disclaimers are added to the appropriate documentation.
+Consider adding a <strong>DISCLAIMER</strong> text document.</p>
+</div>
+<div class="sect2">
+<h3 id="update_build">Update Build</h3>
+<div class="paragraph">
+<p>If the project uses <a href="http://maven.apache.org">Apache Maven</a>, the pom will
+need to be updated to reflect that the project is now at Apache. In particular:
+- Update <strong>mailingLists</strong>
+- Update <strong>organization</strong>
+- Update <strong>url</strong>
+- Update <strong>issueManagement</strong>
+- Check <strong>licenses</strong>
+- Update <strong>scm</strong>
+- Update <strong>groupId</strong>
+- Update <strong>manifestEntries</strong>. It is recommended that the
+standard Apache settings are used
+- Update <strong>developers</strong> to use apache IDs (when known)
+- Update <strong>distributionManagement</strong>
+- Consider specifying a <a href="http://maven.apache.org/pom.html#relocation">relocation</a></p>
+</div>
+<div class="paragraph">
+<p>If the project uses <a href="http://ant.apache.org">Apache Ant</a>, the build script
+will probably need to be updated. In particular:
+- Ensure any MANIFESTs generated refer to Apache. It is recommended that the standard Apache settings are used.
+- Check that <strong>LICENSE</strong>, <strong>NOTICE</strong> and - if appropriate - <strong>DISCLAIMER</strong> documents are copied into binary artifacts</p>
+</div>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="issue_tracking_transition">Issue Tracking Transition</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>Issues for Apache projects should be tracked on Apache hardware. Some projects arrive
+with existing issues tracking. So, in the end these need to be replaced (for new development
+at least) by the Apache issues tracker. Options need to be discussed publically on list
+and a consensus reached about the best transition strategy.</p>
+</div>
+</div>
+</div></p>
+
+</div>
+
+		</div>
+		<div id="push"></div>
+    </div>
+    
+    <div id="footer">
+      <div class="container">
+          <p class="muted credit">&copy; 2017 The Apache Software Foundation | Licensed under the Apache License, Version 2.0.<br/>
+          Apache Incubator, Apache, the Apache feather logo, and the Apache Incubator project logo are trademarks of The Apache Software Foundation.</p>
+      </div>
+    </div>
+
+    <script src="../js/jquery-1.11.1.min.js"></script>
+    <script src="../js/bootstrap.min.js"></script>
+    <script src="../js/prettify.js"></script>
+    <script src="../js/readingTime.js"></script>
+    <script src="../js/incubator.js"></script>
+
+  </body>
+</html>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/guides/website.html
----------------------------------------------------------------------
diff --git a/guides/website.html b/guides/website.html
index d6e7248..13dd89d 100644
--- a/guides/website.html
+++ b/guides/website.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/index.html
----------------------------------------------------------------------
diff --git a/index.html b/index.html
index a0e9b2f..599f246 100644
--- a/index.html
+++ b/index.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/podling-story.html
----------------------------------------------------------------------
diff --git a/podling-story.html b/podling-story.html
index 52419d3..f0b0639 100644
--- a/podling-story.html
+++ b/podling-story.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/policy/incubation.html
----------------------------------------------------------------------
diff --git a/policy/incubation.html b/policy/incubation.html
index 4244f5a..547051d 100644
--- a/policy/incubation.html
+++ b/policy/incubation.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/policy/process.html
----------------------------------------------------------------------
diff --git a/policy/process.html b/policy/process.html
index 6309602..a83805c 100644
--- a/policy/process.html
+++ b/policy/process.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/policy/roles_and_responsibilities.html
----------------------------------------------------------------------
diff --git a/policy/roles_and_responsibilities.html b/policy/roles_and_responsibilities.html
index 95ff9a4..ce32fbc 100644
--- a/policy/roles_and_responsibilities.html
+++ b/policy/roles_and_responsibilities.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/sitemap.xml
----------------------------------------------------------------------
diff --git a/sitemap.xml b/sitemap.xml
index e1495cd..2afafc3 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -87,6 +87,11 @@
     </url>
 
     <url>
+    	<loc>https://incubator.apache.org/ngtest/guides/transitioning_asf.html</loc>
+    	<lastmod>2002-10-16</lastmod>
+    </url>
+
+    <url>
     	<loc>https://incubator.apache.org/ngtest/guides/proposal.html</loc>
     	<lastmod>2017-06-24</lastmod>
     </url>
@@ -112,6 +117,11 @@
     </url>
 
     <url>
+    	<loc>https://incubator.apache.org/ngtest/guides/mentor.html</loc>
+    	<lastmod>2002-10-16</lastmod>
+    </url>
+
+    <url>
     	<loc>https://incubator.apache.org/ngtest/guides/participation.html</loc>
     	<lastmod>2002-10-16</lastmod>
     </url>

http://git-wip-us.apache.org/repos/asf/incubator/blob/d694ae5b/whoweare.html
----------------------------------------------------------------------
diff --git a/whoweare.html b/whoweare.html
index c507579..30b27b2 100644
--- a/whoweare.html
+++ b/whoweare.html
@@ -100,6 +100,8 @@
                 
                   <li><a href="https://incubator.apache.org/ngtest/guides/sites.html">Podling Websites</a></li>
                 
+                  <li><a href="https://incubator.apache.org/ngtest/guides/transitioning_asf.html">Initial Code Import</a></li>
+                
                 <li><a href="/clutch">Clutch Report</a></li>
               </ul>
             </li>


---------------------------------------------------------------------
To unsubscribe, e-mail: cvs-unsubscribe@incubator.apache.org
For additional commands, e-mail: cvs-help@incubator.apache.org


Mime
View raw message