You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2016/11/09 12:02:54 UTC
isis git commit: ISIS-1521: updates pmc guidance for new committers
Repository: isis
Updated Branches:
refs/heads/master f0a5e3942 -> 2067553b1
ISIS-1521: updates pmc guidance for new committers
Project: http://git-wip-us.apache.org/repos/asf/isis/repo
Commit: http://git-wip-us.apache.org/repos/asf/isis/commit/2067553b
Tree: http://git-wip-us.apache.org/repos/asf/isis/tree/2067553b
Diff: http://git-wip-us.apache.org/repos/asf/isis/diff/2067553b
Branch: refs/heads/master
Commit: 2067553b1072c383a74ca4af95e52cf92d9eac3a
Parents: f0a5e39
Author: Dan Haywood <da...@haywood-associates.co.uk>
Authored: Wed Nov 9 12:02:26 2016 +0000
Committer: Dan Haywood <da...@haywood-associates.co.uk>
Committed: Wed Nov 9 12:02:26 2016 +0000
----------------------------------------------------------------------
.../main/asciidoc/guides/_cgcom_pmc-notes.adoc | 240 +++++++++++++++++--
1 file changed, 219 insertions(+), 21 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/isis/blob/2067553b/adocs/documentation/src/main/asciidoc/guides/_cgcom_pmc-notes.adoc
----------------------------------------------------------------------
diff --git a/adocs/documentation/src/main/asciidoc/guides/_cgcom_pmc-notes.adoc b/adocs/documentation/src/main/asciidoc/guides/_cgcom_pmc-notes.adoc
index 4535cf8..1c897d5 100644
--- a/adocs/documentation/src/main/asciidoc/guides/_cgcom_pmc-notes.adoc
+++ b/adocs/documentation/src/main/asciidoc/guides/_cgcom_pmc-notes.adoc
@@ -6,7 +6,9 @@
:toc: right
-Every ASF project has a Project Management Committee, or PMC. This committee is ultimately responsible for the long-term management of the framework. More information about PMCs can be found link:http://www.apache.org/dev/pmc.html[here]
+Every ASF project has a Project Management Committee, or PMC.
+This committee is ultimately responsible for the long-term management of the framework.
+More information about PMCs can be found link:http://www.apache.org/dev/pmc.html[here]
In Apache Isis, every committer is a member of the PMC.
@@ -14,58 +16,254 @@ This page contains some general notes on maintenance activities required by PMC
-== Accessing `people.apache.org`
+== Prereqs
-Must be accessed via ssh.
-
-eg:
+To complete the procedures documented here, you'll need `ssh` access to `minotaur.apache.org`.
+For example:
[source,bash]
----
-ssh danhaywood@people.apache.org
+ssh danhaywood@minotaur.apache.org
----
-and when prompted, provide passphrase for private key... though I've forgotten what I did to set this up in the first place, though :-(
+When prompted, provide passphrase for private key.
+
+[NOTE]
+====
+To set up ssh in the first place, take a look at https://www.apache.org/dev/new-committers-guide.html#ssh-setup[this section in the ASF new committers' guide] looks relevant.
+====
+
+
+== New Committer/PMC member
+Currently we don't distinguish between committers and PMC members: every committer is automatically invited to also be a member of the PMC.
+Further notes on the steps for new PMC members can be found http://www.apache.org/dev/pmc.html#newpmc[here].
-== LDAP Access (UNIX groups)
+=== Start a vote thread on private@
-Whenever we get a new committer, the ASF LDAP entries must be maintained to grant access to our repos and various other 'karma'.
+First, send a [VOTE] email to `private@isis.apache.org`, making the case for the new committer to join.
-Log onto `people.apache.org`, then use:
+For example:
[source]
----
-list_unix_group.pl isis
+[VOTE] Joe Bloggs as a committer and PMC Member <1>
----
+<1> update as required
-to list committers
+with body:
[source]
----
-list_committee.pl isis
+I'd like to nominate Joe Bloggs as a committer and also a PMC member for Apache Isis. <1>
+
+Joe this ... <1>
+
+Joe that ... <1>
+
+Overall, I think Joe would be a great addition to Isis' committers and PMC; ...
+
+Voting ends in one week's time, i.e. midnight UTC on YYYY-MM-DD <1>
+http://www.timeanddate.com/countdown/to?year=YYYY&month=MM&day=DD
----
+<1> update as required
+
+By convention, we run these votes for 7 days (a minimum of 3 days is required by ASF).
-to list the PMC committee members (in Apache Isis, every committer should be on the PMC committee)
-To change membership of either the committers or the PMC, use:
+
+=== Close the vote, announce results
+
+After the 7 days has expired, close the vote thread.
[source]
----
-modify_unix_group.pl isis --add joebloggs
-modify_unix_group.pl isis --remove joebloggs
+I'm now closing this vote. Result will be posted on a new thread.
+----
+
+In a separate thread, announce the results.
+For example:
+
+[source]
+----
+[RESULT] [VOTE] Joe Bloggs as a committer and PMC Member <1>
+----
+<1> update as required
+
+with body:
+
+[source]
+----
+The vote has now closed. The results are:
+
++3 (PMC) <1>
+
+consisting of:
+* Mary (PMC) <1>
+* Mungo (PMC)
+* Midge (PMC)
+
+There were no other votes cast.
+
+The vote is ***successful***
+
+I'll announce to users@ and dev@ by separate thread.
+----
+<1> update as required
+
+
+
+=== ICLA, obtain new account
+
+If required (that is, if the committer is not already a committer for a different ASF project),
+then ask them to complete an ICLA.
+As a result of this, they should also get an @apache.org user name.
+
+More info can be found in the https://www.apache.org/dev/new-committers-guide.html#icla-required-before-account-creation[ASF new committers guide].
+
+
+=== Update the `isis` unix group
+
+All committers must be added to the `isis` UNIX group.
+This will give them commit access to the Apache Isis git repo.
+
+To do this, log onto `minotaur.apache.org`, then eg:
+
+[source,bash]
+----
+list_unix_group.pl isis
----
and
+[source,bash]
+----
+modify_unix_group.pl isis --add joebloggs <1>
+----
+<1> update as required
+
+=== Update the LDAP committee (if a PMC member)
+
+(Assuming that the new committer is a PMC member), also add them as to the PMC committee.
+This takes two steps:
+
+* first, log onto `minotaur.apache.org` and update LDAP committee: +
++
+[source,bash]
+----
+list_committee.pl isis
+----
++
+and +
++
+[source,bash]
+----
+modify_committee.pl isis --add joebloggs <1>
+----
+<1> update as required
+
+* second, update `committee-info.txt` +
++
+This is held in SVN, under https://svn.apache.org/repos/private[https://svn.apache.org/repos/private]; the file resides at `committers/board/committee-info.txt`
+
+The new committer does not officially become a member of the PMC until the ASF records have been updated.
+
+
+=== Notify the ASF board and private mailing list
+
+Send a `[NOTICE]` email to `board@apache.org` and also to `private@isis.apache.org`
+
+For example:
+
[source]
----
-modify_committee.pl gump --add joebloggs
-modify_committee.pl gump --remove joebloggs
+[NOTICE] Joe Bloggs to join Apache Isis as committer and member of the PMC <1>
----
+<1> update as required
+
+with body:
+
+[source]
+----
+The Apache Isis PMC has voted Joe Bloggs as a committer and also member of the PMC. <1>
+
+Voting thread:
+https://mail-search.apache.org/members/private-arch/isis-private/xxx <1>
+
+Results announcement:
+https://mail-search.apache.org/members/private-arch/isis-private/xxx <1>
+
+The committee-info.txt file has been updated, as have the LDAP groups (modify_unix_group.pl, modify_committee.pl).
+----
+<1> update as required
+
+[NOTE]
+====
+update the private threads above
+====
+
+
+=== Announce to the world.
+
+Send an `[ANNOUNCE]` email TO `users@isis.apache.org` and to `dev@isis.apache.org`.
+
+For example:
+
+[source]
+----
+[ANNOUNCE] New committer - Joe Bloggs <1>
+----
+<1> update as required
+
+with body:
+
+[source]
+----
+I'm delighted to announce that Joe Bloggs has been voted in as a committer on Isis, and also as a member of the Isis PMC. The first gives Joe the right to commit changes directly to Isis' codebase, the second gives him the right to be involved in future votes.
+
+Joe this ... <1>
+
+Joe that ...
+
+I'm looking forward to working with Joe in the future; another great addition to Isis' committers. So please join me in welcoming him to our happy band!
+
+Dan Haywood
+Apache Isis PMC Chair
+----
+<1> update as required
+
+
+Also, write a similar blog post at https://blogs.apache.org/isis[blogs.apache.org/isis]
+
+
+
+
+== Removing a committer
+
+[WARNING]
+====
+these notes are only draft, will need fleshing out.
+====
+
+* remove from `isis` UNIX group: +
++
+[source]
+----
+modify_unix_group.pl isis --remove joebloggs
+----
+
+* remove from `isis` committee: +
++
+[source]
+----
+modify_committee.pl isis --add joebloggs
+modify_committee.pl isis --remove joebloggs
+----
+
+* remove from `committee-info.txt`
+
+* send a [NOTICE] email to board@ and private@
-respectively.
-Further details are in http://www.apache.org/dev/pmc.html#SVNaccess[these ASF docs]. (They talk about SVN access, but really it is LDAP access).
\ No newline at end of file