Orc bylaws: typos & edits

[Lefty Leverenz <le...@gmail.com>]

This is mainly for Owen, although all opinions are welcome.

Editorial suggestions for the Orc bylaws (first draft):

Introduction

   - 2nd paragraph:  add '(ASF)' because later you use the acronym
   - last para:  add link to Incubator <http://incubator.apache.org/>

Roles and Responsibilities

   - end period needed:  'The roles are defined in the following sections'

Contributors

   - this sentence no verb:  'All of the volunteers who are contributing
   time, code, documentation, or resources to the Orc Project.'  (It's okay as
   is, but could change to 'Contributors are all ...' to make it more formal.)
   - new paragraph:  'A contributor that makes sustained, ...' (and maybe
   change 'that' to 'who' to match phrase in Committers)

Committers

   - spell out PMC at first occurrence (2nd para)
   - lowercase committer:  'requirements for Committers.' (2nd para; also
   see request in DISCUSS thread for explanation of active & emeritus)
   - new paragraph:  'A committer who makes a sustained contribution ...'

Project Management Committee

   - end periods needed on 1st & last 3 bullets
   - add 'and' in 2nd bullet:  'repository, mailing lists, websites.'
   - inconsistency of quotes around emeritus:  considered emeritus
   (Committer) vs. considered "emeritus" (PMC)
   - again, explain active vs. emeritus (from DISCUSS thread)

Decision Making

   - superfluous 'approval':  'decisions which require "consensus approval"
   approval' (could say ' "consensus" approval' or omit 2nd approval)

Voting

   - colon needed:  'Voting may take four flavors' (end of 1st para)
   - first voting bullet has dash after +1 but the other 3 don't -- omit it
   or add to all bullets
   - en dash preferable to hyphen, but that's a matter of style (also
   occurs in text in Vetoes section)
   - end period needed:  "making it happen" (1st bullet)
   - last para: hyphenate 'Non binding' or make it one word

Approvals

   - end period or colon needed:  'Different actions require different
   types of approvals'

Product Release

   - typo:  'canidate' (occurs twice)

New PMC Member

   - 'To promote a committer to a PMC member, it requires ...' -- omit
   comma & 'it'

Modifying Bylaws

   - add 'a':  'Modifying this document requires [a] lazy majority'


If you want me to make any or all of these changes, I'll need to reset my
github account.

-- Lefty

Re: Orc bylaws: typos & edits

[Lefty Leverenz <le...@gmail.com>]

Thanks so much, Owen.  I want to give it a +1 but found two little quibbles:

Voting:  'Voting may take four flavors:' -- but now there are 5.

Voting:  'The voter, however[,] will not be able to help.' (*tsk, I missed
that on the first pass*)


The substance changes in the DISCUSS thread are all good.  Thanks again.

-- Lefty


On Mon, Jul 20, 2015 at 5:51 PM, Owen O'Malley <om...@apache.org> wrote:

> I think I captured all of your changes:
>
> Current state:
> https://github.com/omalley/orc/blob/bylaws/site/develop/bylaws.md
> Edits:
>
> https://github.com/omalley/orc/commit/3f952cbfd30786b34da3fd5308d92204a5d01516
>

Re: Orc bylaws: typos & edits

[Owen O'Malley <om...@apache.org>]

I think I captured all of your changes:

Current state:
https://github.com/omalley/orc/blob/bylaws/site/develop/bylaws.md
Edits:
https://github.com/omalley/orc/commit/3f952cbfd30786b34da3fd5308d92204a5d01516