You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@activemq.apache.org by cl...@apache.org on 2015/06/25 22:47:14 UTC
[1/2] activemq-artemis git commit: Update hacking guide
Repository: activemq-artemis
Updated Branches:
refs/heads/master ab00b7c57 -> 048173d0e
Update hacking guide
Update the Hacking Guide based on a recent conversation on the dev
list.
Project: http://git-wip-us.apache.org/repos/asf/activemq-artemis/repo
Commit: http://git-wip-us.apache.org/repos/asf/activemq-artemis/commit/ed4200d6
Tree: http://git-wip-us.apache.org/repos/asf/activemq-artemis/tree/ed4200d6
Diff: http://git-wip-us.apache.org/repos/asf/activemq-artemis/diff/ed4200d6
Branch: refs/heads/master
Commit: ed4200d65e5f722c536eca3fa5393c4cd2bae626
Parents: ab00b7c
Author: jbertram <jb...@apache.org>
Authored: Thu Jun 25 14:13:36 2015 -0500
Committer: jbertram <jb...@apache.org>
Committed: Thu Jun 25 14:14:00 2015 -0500
----------------------------------------------------------------------
docs/hacking-guide/en/code.md | 13 +++++++++----
docs/hacking-guide/en/maintainers.md | 22 +++++++++++++++++++++-
2 files changed, 30 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/ed4200d6/docs/hacking-guide/en/code.md
----------------------------------------------------------------------
diff --git a/docs/hacking-guide/en/code.md b/docs/hacking-guide/en/code.md
index 7c9b005..8ca27f6 100644
--- a/docs/hacking-guide/en/code.md
+++ b/docs/hacking-guide/en/code.md
@@ -1,11 +1,16 @@
# Working with the Code
While the canonical Apache ActiveMQ Artemis git repository is hosted on Apache hardware at https://git-wip-us.apache.org/repos/asf?p=activemq-artemis.git
-the developers use a mirror on GitHub for collaboration and pull-request review functionality.
+contributors are encouraged (but not required) to use a mirror on GitHub for collaboration and pull-request review
+functionality. Follow the steps below to get set up with GitHub, etc.
+
+If you do not wish to use GitHub for whatever reason you can follow the overall process outlined in the "Typical
+development cycle" section below but instead attach [a patch file](http://git-scm.com/docs/git-format-patch) to the
+related JIRA or an email to the [dev list](http://activemq.apache.org/mailing-lists.html).
## Initial Steps
-1. Create a github account if you don't have one already
+1. Create a GitHub account if you don't have one already
http://github.com
@@ -116,7 +121,7 @@ the developers use a mirror on GitHub for collaboration and pull-request review
1. Get your changes merged into upstream
- 1. Send a github pull request, by clicking the pull request link while in your repo's fork.
+ 1. Send a GitHub pull request, by clicking the pull request link while in your repo's fork.
1. An email will automatically be sent to the ActiveMQ developer list.
1. As part of the review you may see an automated test run comment on your request.
1. After review a maintainer will merge your PR into the canonical git repository at which point those changes will
@@ -137,7 +142,7 @@ the developers use a mirror on GitHub for collaboration and pull-request review
$ git fetch upstream
$ git pull
-1. Pushing pulled updates (or local commits if you aren't using topic branches) to your private github repo (origin)
+1. Pushing pulled updates (or local commits if you aren't using topic branches) to your private GitHub repo (origin)
$ git push
Counting objects: 192, done.
http://git-wip-us.apache.org/repos/asf/activemq-artemis/blob/ed4200d6/docs/hacking-guide/en/maintainers.md
----------------------------------------------------------------------
diff --git a/docs/hacking-guide/en/maintainers.md b/docs/hacking-guide/en/maintainers.md
index 5d77af9..9ca2d5a 100644
--- a/docs/hacking-guide/en/maintainers.md
+++ b/docs/hacking-guide/en/maintainers.md
@@ -1,7 +1,27 @@
# Notes for Maintainers
Core ActiveMQ Artemis members have write access to the Apache ActiveMQ Artemis repositories and will be responsible for
-acknowledging and pushing commits contributed via pull requests on GitHub.
+acknowledging and pushing commits contributed via pull requests on GitHub.
+
+Core ActiveMQ Artemis members are also able to push their own commits directly to the canonical Apache repository.
+However, the expectation here is that the developer has made a good effort to test their changes and is reasonably
+confident that the changes that are being committed will not break the build.
+
+What does it mean to be reasonably confident? If the developer has run the same maven commands that the pull-request
+builds are running they can be reasonably confident. Currently the [PR build](https://builds.apache.org/job/ActiveMQ-Artemis-PR-Build/)
+runs this command:
+
+ mvn compile test-compile javadoc:javadoc -Pfast-tests -Pextra-tests test
+
+However, if the changes are significant, touches a wide area of code, or even if the developer just wants a second
+opinion they are encouraged to engage other members of the community to obtain an additional review prior to pushing.
+This can easily be done via a pull request on GitHub, a patch file attached to an email or JIRA, commit to a branch
+in the Apache git repo, etc. Having additional eyes looking at significant changes prior to committing to the main
+development branches is definitely encouraged if it helps obtain the "reasonable confidence" that the build is not
+broken and code quality has not decreased.
+
+If the build does break then developer is expected to make their best effort to get the builds fixed in a reasonable
+amount of time. If it cannot be fixed in a reasonable amount of time the commit can be reverted and re-reviewed.
## Commit Messages
[2/2] activemq-artemis git commit: This closes #51 Hacking guide
changes
Posted by cl...@apache.org.
This closes #51 Hacking guide changes
Project: http://git-wip-us.apache.org/repos/asf/activemq-artemis/repo
Commit: http://git-wip-us.apache.org/repos/asf/activemq-artemis/commit/048173d0
Tree: http://git-wip-us.apache.org/repos/asf/activemq-artemis/tree/048173d0
Diff: http://git-wip-us.apache.org/repos/asf/activemq-artemis/diff/048173d0
Branch: refs/heads/master
Commit: 048173d0e27a7047dda0b2b4df2875c92b732071
Parents: ab00b7c ed4200d
Author: Clebert Suconic <cl...@apache.org>
Authored: Thu Jun 25 16:46:21 2015 -0400
Committer: Clebert Suconic <cl...@apache.org>
Committed: Thu Jun 25 16:46:21 2015 -0400
----------------------------------------------------------------------
docs/hacking-guide/en/code.md | 13 +++++++++----
docs/hacking-guide/en/maintainers.md | 22 +++++++++++++++++++++-
2 files changed, 30 insertions(+), 5 deletions(-)
----------------------------------------------------------------------