[07/12] git commit: style changes

[bo...@apache.org]

style changes


Project: http://git-wip-us.apache.org/repos/asf/incubator-storm/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-storm/commit/4bcda700
Tree: http://git-wip-us.apache.org/repos/asf/incubator-storm/tree/4bcda700
Diff: http://git-wip-us.apache.org/repos/asf/incubator-storm/diff/4bcda700

Branch: refs/heads/master
Commit: 4bcda70018fb0977f6f2d96b17a6f948ce1d0344
Parents: b7d8084
Author: Derek Dagit <de...@yahoo-inc.com>
Authored: Mon Jul 7 12:04:04 2014 -0500
Committer: Derek Dagit <de...@yahoo-inc.com>
Committed: Mon Jul 7 12:04:04 2014 -0500

----------------------------------------------------------------------
 BYLAWS.md | 50 ++++++++++++++++++++++++++++----------------------
 1 file changed, 28 insertions(+), 22 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-storm/blob/4bcda700/BYLAWS.md
----------------------------------------------------------------------
diff --git a/BYLAWS.md b/BYLAWS.md
index b9ca532..a6cc4db 100644
--- a/BYLAWS.md
+++ b/BYLAWS.md
@@ -2,7 +2,7 @@
 
 ## Roles and Responsibilities
 
-Apache projects define a set of roles with associated rights and responsibilities. These roles govern what tasks an individual may perform within the project. The roles are defined in the following sections
+Apache projects define a set of roles with associated rights and responsibilities. These roles govern what tasks an individual may perform within the project. The roles are defined in the following sections:
 
 ### Users:
 
@@ -12,27 +12,27 @@ Users contribute to the Apache projects by providing feedback to developers in t
 
 ### Contributors:
 
-All of the volunteers who are contributing time, code, documentation, or resources to the Storm Project. A contributor that makes sustained, welcome contributions to the project may be invited to become a Committer, though the exact timing of such invitations depends on many factors.
+Contributors are all of the volunteers who are contributing time, code, documentation, or resources to the Storm Project. A contributor that makes sustained, welcome contributions to the project may be invited to become a Committer, though the exact timing of such invitations depends on many factors.
 
 ### Committers:
 
 The project's Committers are responsible for the project's technical management. Committers have access to all project source repositories. Committers may cast binding votes on any technical discussion regarding storm.
 
-Committer access is by invitation only and must be approved by lazy consensus of the active PMC members. A Committer is considered emeritus by their own declaration or by not contributing in any form to the project for over six months. An emeritus committer may request reinstatement of commit access from the PMC. Such reinstatement is subject to lazy consensus approval of active PMC members.
+Committer access is by invitation only and must be approved by lazy consensus of the active PMC members. A Committer is considered emeritus by their own declaration or by not contributing in any form to the project for over six months. An emeritus Committer may request reinstatement of commit access from the PMC. Such reinstatement is subject to lazy consensus approval of active PMC members.
 
-All Apache committers are required to have a signed Contributor License Agreement (CLA) on file with the Apache Software Foundation. There is a Committer FAQ which provides more details on the requirements for Committers
+All Apache Committers are required to have a signed Contributor License Agreement (CLA) on file with the Apache Software Foundation. There is a [Committers' FAQ](https://www.apache.org/dev/committers.html) which provides more details on the requirements for Committers.
 
-A committer who makes a sustained contribution to the project may be invited to become a member of the PMC. The form of contribution is not limited to code. It can also include code review, helping out users on the mailing lists, documentation, testing, etc.
+A Committer who makes a sustained contribution to the project may be invited to become a member of the PMC. The form of contribution is not limited to code. It can also include code review, helping out users on the mailing lists, documentation, testing, etc.
 
 ### Project Management Committee(PMC):
 
-The PMC is responsible to the board and the ASF for the management and oversight of the Apache Storm codebase. The responsibilities of the PMC include
+The PMC is responsible to the board and the ASF for the management and oversight of the Apache Storm codebase. The responsibilities of the PMC include:
 
  * Deciding what is distributed as products of the Apache Storm project. In particular all releases must be approved by the PMC.
  * Maintaining the project's shared resources, including the codebase repository, mailing lists, websites.
  * Speaking on behalf of the project.
  * Resolving license disputes regarding products of the project.
- * Nominating new PMC members and committers.
+ * Nominating new PMC members and Committers.
  * Maintaining these bylaws and other guidelines of the project.
 
 Membership of the PMC is by invitation only and must be approved by a consensus approval of active PMC members. A PMC member is considered "emeritus" by their own declaration or by not contributing in any form to the project for over six months. An emeritus member may request reinstatement to the PMC. Such reinstatement is subject to consensus approval of the active PMC members.
@@ -43,28 +43,34 @@ The chair of the PMC is rotated annually. When the chair is rotated or if the cu
 
 ## Voting
 
-Decisions regarding the project are made by votes on the primary project development mailing list (dev@storm.incubator.apache.org). Where necessary, PMC voting may take place on the private Storm PMC mailing list. Votes are clearly indicated by subject line starting with [VOTE]. Votes may contain multiple items for approval and these should be clearly separated. Voting is carried out by replying to the vote mail. Voting may take four flavors
+Decisions regarding the project are made by votes on the primary project development mailing list (dev@storm.incubator.apache.org). Where necessary, PMC voting may take place on the private Storm PMC mailing list. Votes are clearly indicated by subject line starting with [VOTE]. Votes may contain multiple items for approval and these should be clearly separated. Voting is carried out by replying to the vote mail. Voting may take four flavors:
 	
 | Vote | Meaning |
 |------|---------|
 | +1 | 'Yes,' 'Agree,' or 'the action should be performed.' |
-| +0 | Neutral about the proposed action (or mildly negative but not enough so to want to block it). |
+| +0 | Neutral about the proposed action. |
+| -0 | Mildly negative, but not enough so to want to block it. |
 | -1 |This is a negative vote. On issues where consensus is required, this vote counts as a veto. All vetoes must contain an explanation of why the veto is appropriate. Vetoes with no explanation are void. It may also be appropriate for a -1 vote to include an alternative course of action. |
 
-All participants in the Storm project are encouraged to show their agreement with or against a particular action by voting. For technical decisions, only the votes of active committers are binding. Non-binding votes are still useful for those with binding votes to understand the perception of an action in the wider Storm community. For PMC decisions, only the votes of active PMC members are binding.
+All participants in the Storm project are encouraged to show their agreement with or against a particular action by voting. For technical decisions, only the votes of active Committers are binding. Non-binding votes are still useful for those with binding votes to understand the perception of an action in the wider Storm community. For PMC decisions, only the votes of active PMC members are binding.
 
 Voting can also be applied to changes already made to the Storm codebase. These typically take the form of a veto (-1) in reply to the commit message sent when the commit is made. Note that this should be a rare occurrence. All efforts should be made to discuss issues when they are still patches before the code is committed.
 
-Only active (i.e. non-emeritus) committers and PMC members have binding votes.
+Only active (i.e. non-emeritus) Committers and PMC members have binding votes.
 
 ## Approvals
 
 These are the types of approvals that can be sought. Different actions require different types of approvals
 
-* Consensus Approval - Consensus approval requires 3 binding +1 votes and no binding vetoes.
-* Lazy Consensus - Lazy consensus requires no -1 votes ('silence gives assent').
-* Lazy Majority - A lazy majority vote requires 3 binding +1 votes and more binding +1 votes than -1 votes.
-* Lazy 2/3 Majority - Lazy 2/3 majority votes requires at least 3 votes and twice as many +1 votes as -1 votes.
+| Approval Type | Criteria |
+|---------------|----------|
+| Consensus Approval | Consensus approval requires 3 binding +1 votes and no binding vetoes. |
+|---------------|----------|
+| Lazy Consensus | Lazy consensus requires no -1 votes ('silence gives assent'). |
+|---------------|----------|
+| Lazy Majority | A lazy majority vote requires 3 binding +1 votes and more binding +1 votes than -1 votes. |
+|---------------|----------|
+| Lazy 2/3 Majority | Lazy 2/3 majority votes requires at least 3 votes and twice as many +1 votes as -1 votes. |
 
 ### Vetoes
 
@@ -78,14 +84,14 @@ This section describes the various actions which are undertaken within the proje
 
 | Actions | Description | Approval | Binding Votes | Minimum Length | Mailing List |
 |---------|-------------|----------|---------------|----------------|--------------|
-| Code Change | A change made to a source code of the project and committed by a committer. | One +1 from a committer other than the one who authored the patch, and no -1s. | Active committers | 2 days from initial patch |JIRA or Github pull ( with notification sent to dev@storm.incubator.apache.org) |
-| Non-Code Change | A change made to a repository of the project and committed by a committer. This includes documentation, website content, etc., but not source code, unless only comments are being modified. | Lazy Consensus | Active committers | At the discression of the committer |JIRA or Github pull (with notification sent to dev@storm.incubator.apache.org) |
-| Product Release | A vote is required to accept a proposed release as an official release of the project. Any committer may call for a release vote at any point in time. | Lazy Majority | Active PMC members | 7 days | dev@storm.incubator.apache.org |
+| Code Change | A change made to a source code of the project and committed by a Committer. | One +1 from a Committer other than the one who authored the patch, and no -1s. | Active Committers | 2 days from initial patch |JIRA or Github pull ( with notification sent to dev@storm.incubator.apache.org) |
+| Non-Code Change | A change made to a repository of the project and committed by a Committer. This includes documentation, website content, etc., but not source code, unless only comments are being modified. | Lazy Consensus | Active Committers | At the discression of the Committer |JIRA or Github pull (with notification sent to dev@storm.incubator.apache.org) |
+| Product Release | A vote is required to accept a proposed release as an official release of the project. Any Committer may call for a release vote at any point in time. | Lazy Majority | Active PMC members | 7 days | dev@storm.incubator.apache.org |
 | Adoption of New Codebase | When the codebase for an existing, released product is to be replaced with an alternative codebase. If such a vote fails to gain approval, the existing code base will continue. This also covers the creation of new sub-projects and submodules within the project. | Lazy 2/3 majority | Active PMC members | 7 days | dev@storm.incubator.apache.org |
-| New Committer | When a new committer is proposed for the project. | Lazy consensus | Active PMC members | 7 days | private@storm.incubator.apache.org |
-| New PMC Member | When a committer is proposed for the PMC. | Consensus Approval | Active PMC members | 7 days | private@storm.incubator.apache.org |
+| New Committer | When a new Committer is proposed for the project. | Lazy consensus | Active PMC members | 7 days | private@storm.incubator.apache.org |
+| New PMC Member | When a Committer is proposed for the PMC. | Consensus Approval | Active PMC members | 7 days | private@storm.incubator.apache.org |
 | Emeritus PMC Member re-instatement | When an emeritus PMC member requests to be re-instated as an active PMC member. | Consensus Approval | Active PMC members | 7 days | private@storm.incubator.apache.org |
-| Emeritus Committer re-instatement | When an emeritus committer requests to be re-instated as an active committer. | Consensus Approval | Active PMC members | 7 days | private@storm.incubator.apache.org |
-| Committer Removal | When removal of commit privileges is sought. Note: Such actions will also be referred to the ASF board by the PMC chair. | Consensus Approval | Active PMC members (excluding the committer in question if a member of the PMC). | 7 Days | private@storm.incubator.apache.org |
+| Emeritus Committer re-instatement | When an emeritus Committer requests to be re-instated as an active Committer. | Consensus Approval | Active PMC members | 7 days | private@storm.incubator.apache.org |
+| Committer Removal | When removal of commit privileges is sought. Note: Such actions will also be referred to the ASF board by the PMC chair. | Consensus Approval | Active PMC members (excluding the Committer in question if a member of the PMC). | 7 Days | private@storm.incubator.apache.org |
 | PMC Member Removal | When removal of a PMC member is sought. Note: Such actions will also be referred to the ASF board by the PMC chair. | Consensus Approval | Active PMC members (excluding the member in question). | 7 Days | private@storm.incubator.apache.org |
 | Modifying Bylaws | Modifying this document. | Lazy 2/3 majority | Active PMC members | 7 Days | dev@storm.incubator.apache.org |