Repository: incubator-apex-site Updated Branches: refs/heads/asf-site b4010431c -> c85c72ebb
from f21aaee29ce781614845a176fc87c1b763fcd0b6 Project: http://git-wip-us.apache.org/repos/asf/incubator-apex-site/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-apex-site/commit/c85c72eb Tree: http://git-wip-us.apache.org/repos/asf/incubator-apex-site/tree/c85c72eb Diff: http://git-wip-us.apache.org/repos/asf/incubator-apex-site/diff/c85c72eb Branch: refs/heads/asf-site Commit: c85c72ebb4656b87e3ab3a5eb445922c62deae8e Parents: b401043 Author: sashadt <[email protected]> Authored: Fri Jan 29 11:15:53 2016 -0800 Committer: sashadt <[email protected]> Committed: Fri Jan 29 11:15:53 2016 -0800 ---------------------------------------------------------------------- content/contributing.html | 26 +++++++++++++------------- content/release.html | 12 ++++++------ 2 files changed, 19 insertions(+), 19 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-apex-site/blob/c85c72eb/content/contributing.html ---------------------------------------------------------------------- diff --git a/content/contributing.html b/content/contributing.html index bcde403..622edb1 100644 --- a/content/contributing.html +++ b/content/contributing.html @@ -96,12 +96,12 @@ <p>The Podling Project Management Committee (<a href="http://incubator.apache.org/guides/ppmc.html";>PPMC</a>) is responsible for the oversight of the project and it also decides who to add as a PPMC member. Existing committers may be invited to become a PPMC member after consistent contribution and activity over a period of time and participation in directional and community building discussions.</p> <h2 id="code-style">Code Style</h2> <p>Apache Apex follows coding style that is closest to K & R style and uses <a href="http://checkstyle.sourceforge.net/";>Checkstyle</a> tool to enforce these standards. Travis CI will fail for any pull request that introduces any style violations.</p> -<p>The checkstyle configuration that Apache Apex projects use is present here : <a href="https://github.com/apache/incubator-apex-core/blob/devel-3/apex_checks.xml";>https://github.com/apache/incubator-apex-core/blob/devel-3/apex_checks.xml</a></p> +<p>The checkstyle configuration that Apache Apex projects use is present here : <a href="https://github.com/apache/incubator-apex-core/blob/master/apex_checks.xml";>https://github.com/apache/incubator-apex-core/blob/master/apex_checks.xml</a></p> <p>To make it easier for the users to set up their development environment, settings for the following common IDEs are provided in the Apache Apex Core repository with instructions.</p> <ul> -<li><a href="https://github.com/apache/incubator-apex-core/tree/devel-3/misc/ide-templates/intellij";>IntelliJ</a></li> -<li><a href="https://github.com/apache/incubator-apex-core/tree/devel-3/misc/ide-templates/eclipse";>Eclipse</a></li> -<li><a href="https://github.com/apache/incubator-apex-core/tree/devel-3/misc/ide-templates/netbeans";>NetBeans</a></li> +<li><a href="https://github.com/apache/incubator-apex-core/tree/master/misc/ide-templates/intellij";>IntelliJ</a></li> +<li><a href="https://github.com/apache/incubator-apex-core/tree/master/misc/ide-templates/eclipse";>Eclipse</a></li> +<li><a href="https://github.com/apache/incubator-apex-core/tree/master/misc/ide-templates/netbeans";>NetBeans</a></li> </ul> <h2 id="opening-pull-requests-contributors-">Opening Pull Requests (contributors)</h2> <p>The apex-core and apex-malhar repositories both have mirror repositories on github which are used to review pull requests and provide a second remote endpoint for the codebase.</p> @@ -110,13 +110,13 @@ <li>Fork the ASF github mirror (one time step):<br><a href="https://github.com/apache/incubator-apex-core/";>https://github.com/apache/incubator-apex-core/</a> </li> <li>Clone the <strong>fork</strong> on your local workspace (one time step):<br><code>git clone https://github.com/{github_username}/incubator-apex-core.git</code></li> <li>Add <a href="https://github.com/apache/incubator-apex-core";>incubator apex core</a> as a remote repository (one time step):<br><code>git remote add upstream https://github.com/apache/incubator-apex-core</code></li> -<li>Create a new branch from the <a href="https://github.com/apache/incubator-apex-core/tree/devel-3";>devel-3</a> branch. <strong>Name your branch with the JIRA number in it, e.g. <code>APEXCORE-123.my-feature</code>.</strong><br><code>git checkout -b APEXCORE-123.my-feature -t upstream/devel-3</code><br>Creating a local branch that tracks a remote makes pull easier (no need to specify the remote branch while pulling). A branch can be made to track a remote branch anytime, not necessarily at its creation by:<br><code>git branch -u upstream/devel-3</code></li> +<li>Create a new branch from the <a href="https://github.com/apache/incubator-apex-core/tree/master";>master</a> branch. <strong>Name your branch with the JIRA number in it, e.g. <code>APEXCORE-123.my-feature</code>.</strong><br><code>git checkout -b APEXCORE-123.my-feature -t upstream/master</code><br>Creating a local branch that tracks a remote makes pull easier (no need to specify the remote branch while pulling). A branch can be made to track a remote branch anytime, not necessarily at its creation by:<br><code>git branch -u upstream/master</code></li> <li>When adding new files, please include the Apache v2.0 license header.<ul> <li>From the top level directory, run <code>mvn license:check -Dlicense.skip=false</code> to check correct header formatting.</li> <li>Run <code>mvn license:format -Dlicense.skip=false</code> to automatically add the header when missing.</li> </ul> </li> -<li>Once your feature is complete, submit the pull request on github against <code>devel-3</code>.</li> +<li>Once your feature is complete, submit the pull request on github against <code>master</code>.</li> <li>If you want specific people to review your pull request, use the <code>@</code> notation in Github comments to mention that user, and request that he/she reviews your changes.</li> <li>Check the status of the pull request and ensure the Travis CI build is successful. If not, inspect the linked build log for details.<ul> <li>If build fails due to license headers, follow instructions above.</li> @@ -125,7 +125,7 @@ </li> <li>Add changes after the PR was opened to the same branch, Travis CI will detect changes and build automatically. To force the CI run, close and re-open the PR.</li> <li><p>After all review is complete, combine all new commits into one squashed commit except when there are multiple contributors, and include the Jira number in the commit message. There are several ways to squash commits, but <a href="https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Squashing-Commits";>here is one explanation from git-scm.com</a> and a simple example is illustrated below:</p> -<p>If tracking upstream/devel-3 then run <code>git rebase -i</code>. Else run <code>git rebase -i upstream/devel-3</code>.<br>This command opens the text editor which lists the multiple commits:</p> +<p>If tracking upstream/master then run <code>git rebase -i</code>. Else run <code>git rebase -i upstream/master</code>.<br>This command opens the text editor which lists the multiple commits:</p> <pre><code>pick 67cd79b change1 pick 6f98905 change2 @@ -145,14 +145,14 @@ pick 6f98905 change2 squash 6f98905 change2 </code></pre></li> <li>If there are multiple contributors in a pull request preserve individual attributions. Try to squash the commits to the minimum number of commits required to preserve attribution and the contribution to still be functionally correct.</li> -<li>Till the review is complete it may happen that working feature branch may diverge from <code>devel-3</code> substantially. Therefore, it is recommended to frequently merge <code>devel-3</code> to the branch being worked on by:<ul> -<li>when the branch tracks upstream/devel-3<br><code>git pull</code></li> -<li>when the branch doesn't track upstream<br><code>git pull upstream devel-3</code></li> +<li>Till the review is complete it may happen that working feature branch may diverge from <code>master</code> substantially. Therefore, it is recommended to frequently merge <code>master</code> to the branch being worked on by:<ul> +<li>when the branch tracks upstream/master<br><code>git pull</code></li> +<li>when the branch doesn't track upstream<br><code>git pull upstream master</code></li> </ul> </li> -<li>If a pull from <code>devel-3</code> results in a conflict then resolve it and commit the merge. This results in additional merge commits in the pull request. Following steps help to ensure that the final pull request contains just one commit:<ul> +<li>If a pull from <code>master</code> results in a conflict then resolve it and commit the merge. This results in additional merge commits in the pull request. Following steps help to ensure that the final pull request contains just one commit:<ul> <li>Rename the original branch:<br><code>git branch -m APEXCORE-123.my-feature.squash</code></li> -<li>Create a new branch (with the original name) from upstream/devel-3 that has latest changes:<br><code>git checkout -b APEXCORE-123.my-feature -t upstream/devel-3</code></li> +<li>Create a new branch (with the original name) from upstream/master that has latest changes:<br><code>git checkout -b APEXCORE-123.my-feature -t upstream/master</code></li> <li>Squash merge the old branch which was renamed. When the new branch has the latest changes then this squash will result only in the changes that were made for the feature:<br><code>git merge --squash APEXCORE-123.my-feature.squash</code></li> <li>Commit the squash and force push it to the old feature remote branch so that the pull request is automatically updated:<br><code>git commit -m "APEXCORE-123 #comment added my-feature"</code><br><code>git push origin +APEXCORE-123.my-feature</code></li> <li>Delete the extra squash branch:<br><code>git branch -D APEXCORE-123.my-feature.squash</code></li> @@ -171,7 +171,7 @@ squash 6f98905 change2 </li> <li>To set up access to the ASF source repository, <a href="https://git-wip-us.apache.org/#committers-getting-started";>follow these steps</a>. The ASF master repository is: <code>https://git-wip-us.apache.org/repos/asf/incubator-apex-core.git</code></li> <li>Use the git command line to pull in the changes from the pull requests. You can refer to the corresponding email that will be automatically sent to the <code>[email protected]</code> mailing list to see the exact commands to merge the given pull request.</li> -<li>Once done with verification, push the changes to the ASF repository's <code>devel-3</code> branch. Within a few<br>seconds, the changes will propagate back to the github mirror and the pull requests be closed and marked merged automatically.</li> +<li>Once done with verification, push the changes to the ASF repository's <code>master</code> branch. Within a few<br>seconds, the changes will propagate back to the github mirror and the pull requests be closed and marked merged automatically.</li> <li>The <code>Fix version</code> field on the corresponding JIRA ticket needs to be set and the ticket resolved after pushing the changes.</li> </ol> <p><strong>Note: since none of us has write access to the mirror, only the author of a pull request can close it if it was not merged.</strong></p> http://git-wip-us.apache.org/repos/asf/incubator-apex-site/blob/c85c72eb/content/release.html ---------------------------------------------------------------------- diff --git a/content/release.html b/content/release.html index 9528a99..9aa8470 100644 --- a/content/release.html +++ b/content/release.html @@ -79,11 +79,11 @@ <p>For general information on ASF releases, see:<br><a href="http://incubator.apache.org/guides/releasemanagement.html";>http://incubator.apache.org/guides/releasemanagement.html</a><br><a href="http://www.apache.org/dev/release.html";>http://www.apache.org/dev/release.html</a></p> <h2 id="creating-release-branch">Creating Release Branch</h2> <p>If this is a minor release (X.Y.0), start with creating a new branch. Example for 3.2.0:</p> -<pre><code class="lang-bash">git checkout devel-3 && git pull -git checkout -b release-3.2 devel-3 +<pre><code class="lang-bash">git checkout master && git pull +git checkout -b release-3.2 master </code></pre> -<p>Replace version in devel-3 branch:</p> -<pre><code>git checkout devel-3 +<p>Replace version in master branch:</p> +<pre><code>git checkout master git grep -l "3.2.0-incubating-SNAPSHOT" </code></pre><p>For informational purpose, this should yield the list of files that needs the version number replaced to X.(Y+1).0 next version. Note that the replacement step is different between the repositories due to an open issue. See:</p> <p><a href="https://issues.apache.org/jira/browse/APEXCORE-34";>https://issues.apache.org/jira/browse/APEXCORE-34</a></p> @@ -96,7 +96,7 @@ for a in `git grep -l "${dv}"`; do echo $a; sed -i 's/'"$ <pre><code>mvn versions:set -DnewVersion=${rv} -Pall-modules </code></pre><p>Commit and push the change:</p> <pre><code>git commit -am "Preparing for 3.3.0 development" -git push apache devel-3 +git push apache master </code></pre><h2 id="preparing-release-candidate">Preparing Release Candidate</h2> <h3 id="add-missing-since-tags">Add missing @since tags</h3> <p>For Java classes added since the last release, the @since tags need to be added. The javadoc plugin inserts missing tags, but does not play well with the license header when no class level documentation block is present. This is tracked as</p> @@ -183,7 +183,7 @@ rv=3.2.1-incubating-SNAPSHOT for a in `git grep -l "${dv}"`; do echo $a; sed -i 's/'"${dv}"'/'"${rv}"'/g' $a; done git commit -am "Preparing for 3.2.1 development" </code></pre> -<p>Merge <code>@since</code> tag and change log changes to <code>devel-3</code></p> +<p>Merge <code>@since</code> tag and change log changes to <code>master</code></p> <h2 id="announce-release">Announce Release</h2> <p><a href="http://mail-archives.apache.org/mod_mbox/incubator-general/201511.mbox/%3CCA%2B5xAo1mS-BMT%3DXk_q287_j5m6ngtaT8QEEED0zfQhXtgrnOtA%40mail.gmail.com%3E";>http://mail-archives.apache.org/mod_mbox/incubator-general/201511.mbox/%3CCA%2B5xAo1mS-BMT%3DXk_q287_j5m6ngtaT8QEEED0zfQhXtgrnOtA%40mail.gmail.com%3E</a></p>
