[mapserver-commits] r8144 - trunk/docs/development/rfc

svn at osgeo.org svn at osgeo.org
Sun Nov 30 15:20:45 EST 2008


Author: hobu
Date: 2008-11-30 15:20:45 -0500 (Sun, 30 Nov 2008)
New Revision: 8144

Modified:
   trunk/docs/development/rfc/ms-rfc-19.txt
   trunk/docs/development/rfc/ms-rfc-21.txt
   trunk/docs/development/rfc/ms-rfc-23.txt
Log:
convert to ReST, styling, break at 80

Modified: trunk/docs/development/rfc/ms-rfc-19.txt
===================================================================
--- trunk/docs/development/rfc/ms-rfc-19.txt	2008-11-30 19:38:44 UTC (rev 8143)
+++ trunk/docs/development/rfc/ms-rfc-19.txt	2008-11-30 20:20:45 UTC (rev 8144)
@@ -129,6 +129,7 @@
 2100_
 
 .. _2100: http://trac.osgeo.org/mapserver/ticket/2100
+
 Voting history
 ~~~~~~~~~~~~~~~~~
 

Modified: trunk/docs/development/rfc/ms-rfc-21.txt
===================================================================
--- trunk/docs/development/rfc/ms-rfc-21.txt	2008-11-30 19:38:44 UTC (rev 8143)
+++ trunk/docs/development/rfc/ms-rfc-21.txt	2008-11-30 20:20:45 UTC (rev 8144)
@@ -80,16 +80,16 @@
 --------------------
 
 All new options are selected via new PROCESSING options.   There is
-no change in the mapfile syntax.  There should be no compatbability problems
+no change in the mapfile syntax.  There should be no compatibility problems
 with old mapfiles. 
 
 
 MapScript Implications
 ----------------------
 
-There are no additions or changes to the mapscript API.  The new
+There are no additions or changes to the MapScript API.  The new
 options are controlled via PROCESSING information on the layers which I
-believe is already manipulatable from mapscript. 
+believe is already manipulatable from MapScript. 
 
 
 Documentation Implications

Modified: trunk/docs/development/rfc/ms-rfc-23.txt
===================================================================
--- trunk/docs/development/rfc/ms-rfc-23.txt	2008-11-30 19:38:44 UTC (rev 8143)
+++ trunk/docs/development/rfc/ms-rfc-23.txt	2008-11-30 20:20:45 UTC (rev 8144)
@@ -1,137 +1,184 @@
-<h2 class="title"><br /></h2><h2 class="title">MS RFC 23: Technical Steering Committee Guidelines</h2>
-<table class="docinfo">
-<col class="docinfo-name" />
-<col class="docinfo-content" />
-<tbody>
-<tr><th class="docinfo-name">Date:</th>
-<td>2005/10/11</td></tr>
-<tr><th class="docinfo-name">Author:</th>
-<td>Frank Warmerdam
-Stephen Lime</td></tr>
-<tr class="field"><th class="docinfo-name">Contacts:</th><td class="field-body"><a class="reference" href="mailto:warmerdam at pobox.com">warmerdam at pobox.com</a>
-<a class="reference" href="mailto:sdlime at dnr.state.mn.us">sdlime at dnr.state.mn.us</a></td>
-</tr>
-<tr class="field"><th class="docinfo-name">Last Edited:</th><td class="field-body">2008/01/25</td>
-</tr>
-<tr><th class="docinfo-name">Status:</th>
-<td>Adopted</td></tr>
-</tbody>
-</table>
-<div id="summary" class="section">
-<h3><a name="summary"></a></h3><h3><br /></h3><h3>Summary</h3>
-<p>This document describes how the MapServer Project Steering Committee 
-determines membership, and makes decisions on all aspects of the MapServer project - both technical and non-technical.</p>
+.. _rfc23:
 
-<p>Examples of PSC management responsibilities:
-<ul>
-  <li> setting the overall development road map</li>
-  <li> developing technical standards and policies (e.g. coding standards, file naming conventions, etc...)</li>
-  <li> ensuring regular releases (major and maintenance) of MapServer software</li> 
-  <li> reviewing RFC for technical enhancements to the software</li>
-  <li> project infrastructure (e.g. CVS/SVN, Bugzilla, hosting options, etc...)
-  <li> formalization of affiliation with external entities such as OSGeo</li>
-  <li> setting project priorities, especially with respect to project sponsorship</li>
-  <li> creation and oversight of specialized sub-committees (e.g. project infrastructure, training)</li>
-</ul>
-<p>
+====================================================================
+MS RFC 23: Technical Steering Committee Guidelines
+====================================================================
 
-<p>In brief the project team votes on proposals on mapserver-dev.  Proposals are available for review for at least two days, and a single veto is sufficient delay progress though ultimately a majority of members can pass a proposal.</p>
-</div>
-<div id="detailed-process" class="section">
-<h3><a name="detailed-process"></a></h3><h3><br /></h3><h3>Detailed Process</h3>
-<ol class="arabic simple">
-<li>Proposals are written up and submitted on the mapserver-dev mailing list for discussion and voting, by any interested party, not just committee members.</li>
-<li>Proposals need to be available for review for at least two business days before a final decision can be made.</li>
-<li>Respondents may vote "+1" to indicate support for the proposal and a willingness to support implementation.</li>
-<li>Respondents may vote "-1" to veto a proposal, but must provide clear reasoning and alternate approaches to resolving the problem within the two days.</li>
-<li>A vote of -0 indicates mild disagreement, but has no effect.  A 0 indicates no opinion.  A +0 indicate mild support, but has no effect.</li>
-<li>Anyone may comment on proposals on the list, but only members of the Project Steering Committee's votes will be counted.</li>
-<li>A proposal will be accepted if it receives +2 (including the author) and no vetoes (-1).</li>
-<li>If a proposal is vetoed, and it cannot be revised to satisfy all parties, then it can be resubmitted for an override vote in which a majority of all eligible voters indicating +1 is sufficient to pass it.  Note that this is a majority of all committee members, not just those who actively vote.</li>
-<li>Upon completion of discussion and voting the author should announce whether they are proceeding (proposal accepted) or are withdrawing their proposal (vetoed).</li>
-<li>The Chair gets a vote.</li>
-<li>The Chair is responsible for keeping track of who is a member of the Project Steering Committee (perhaps as part of a PSC file in CVS).</li>
-<li>Addition and removal of members from the committee, as well as selection of a Chair should be handled as a proposal to the committee.</li>
-<li>The Chair adjudicates in cases of disputes about voting.</li>
-</ol>
-</div>
-<div id="when-is-vote-required" class="section">
-<h3><br /></h3><h3>When is Vote Required?</h3>
-<ul class="simple">
-<li>Any change to committee membership (new members, removing inactive members)</li>
-<li>Changes to project infrastructure (e.g. tool, location or substantive configuration)</li>
-<li>Anything that could cause backward compatibility issues.</li>
-<li>Adding substantial amounts of new code.</li>
-<li>Changing inter-subsystem APIs, or objects.</li>
-<li>Issues of procedure.</li>
-<li>When releases should take place.</li>
-<li>Anything dealing with relationships with external entities such as OSGeo<br /></li>
-<li>Anything that might be controversial.</li>
-</ul>
-</div>
+:Date:  2006/05/12
+:Author: Frank Warmerdam, Steve Lime
+:Contact: warmerdam at pobox.com, sdlime at dnr.state.mn.us
+:Last Edited: 2008/01/25
+:Status: Adopted 
 
-<div id="observations" class="section">
-<h3><br /></h3><h3>Observations</h3>
-<ul class="simple">
-<li>The Chair is the ultimate adjudicator if things break down.</li>
-<li>The absolute majority rule can be used to override an obstructionist veto, but it is intended that in normal circumstances vetoers need to be convinced to withdraw their veto.  We are trying to reach consensus.</li>
-<li>It is anticipated that separate "committees" will exist to manage conferences, documentation and web sites.  That said, it is expected that the PSC will be the entity largely responsible for creating any such committees.<br /></li>
-</ul></div>
+Summary
+-----------
 
-<h3><br /></h3><h3>Committee Membership</h3>The PSC is made up of  individuals consisting of technical contributors (e.g. developers) and prominent members of the MapServer user community.  There is no set number of members for the PSC although the initial desire is to set the membership at 9.<br /><b><br />Adding Members</b><br />Any member of the mapserver-dev mailing list may nominate someone for committee membership at any time. Only existing PSC committee members may vote on new members.  Nominees must receive a majority vote from existing members to be added to the PSC.<br /><br /><b>Stepping Down<br /></b>If for any reason a PSC member is not able to fully participate then they certainly are free to step down.  If a member is not active (e.g. no voting, no IRC or email participation) for a period of two months then the committee reserves the right to seek nominations to fill that position.<br /><br />Should that person become active again (hey, it happens) then they would certainly be welcome, but would require a nomination.<br />
-<h3><br /></h3>
-<h3>Membership Responsibilities</h3>
-<br />
-<b>Guiding Development</b>
-<br /><br />
-Members should take an active role guiding the development of new features they feel passionate about. Once a change request has been accepted and given a green light to proceed does not mean the members are free of their obligation. PSC members voting "+1" for a change request are expected to stay engaged and ensure the change is implemented and documented in a way that is most beneficial to users. Note that this applies not only to change requests that affect code, but also those that affect the web site, technical infrastructure, policies and standards.
-<br /><br />
-<b>IRC Meeting Attendance</b>
-<br /><br />
-PSC members are expected to participate in pre-scheduled IRC development meetings. If known in advance that a member cannot attend a meeting, the member should let the meeting organizer know via e-mail.
-<br /><br />
-<b>Mailing List Participation</b>
-<br /><br />
-PSC members are expected to be active on both the mapserver-users and mapserver-dev mailing lists, subject to open source mailing list etiquette. Non-developer members of the PSC are not expected to respond to coding level questions on the developer mailing list, however they are expected to provide their thoughts and opinions on user level requirements and compatibility issues when RFC discussions take place.
-<br /><br />
-<h3>Bootstrapping</h3>
-<div id="bootstrapping" class="section">
-<h3><a name="bootstrapping"></a></h3>
+This document describes how the MapServer Project Steering Committee 
+determines membership, and makes decisions on all aspects of the 
+MapServer project - both technical and non-technical.
 
-<p>Prior to the TSC anointing itself the PSC this RFC must be distributed before the MapServer community via MapServer-Users for comment. Any and all substantive comments must be discussed (and hopefully, but not necessarily, addressed via MapServer-Dev.</p>
+Examples of PSC management responsibilities:
+* setting the overall development road map
+* developing technical standards and policies (e.g. coding standards, 
+  file naming conventions, etc...)
+* ensuring regular releases (major and maintenance) of MapServer software
+* reviewing RFC for technical enhancements to the software
+* project infrastructure (e.g. CVS/SVN, Bugzilla, hosting options, etc...)
+* formalization of affiliation with external entities such as OSGeo
+* setting project priorities, especially with respect to project sponsorship
+* creation and oversight of specialized sub-committees (e.g. project 
+  infrastructure, training) 
 
-<p>All members of the existing Technical Steering Committee will form the initial Project Steering Committee. Steve Lime is declared initial Chair of the Project Steering Committee.</p>
+In brief the project team votes on proposals on mapserver-dev.  Proposals are 
+available for review for at least two days, and a single veto is sufficient 
+delay progress though ultimately a majority of members can pass a proposal.
 
-<p>Initial members are:
+Detailed Process
+-----------------------
 
- <ul>
-  <li>Steve Lime</li>
-  <li>Daniel Morissette</li>
-  <li>Frank Warmerdam</li>
-  <li>Assefa Yewondwossen</li>
-  <li>Howard Butler</li>
-  <li>Steve Woodbridge</li>
-  <li>Perry Nacionales</li>
- </ul>
-</p>
+* Proposals are written up and submitted on the mapserver-dev mailing list 
+  for discussion and voting, by any interested party, not just 
+  committee members.
+* Proposals need to be available for review for at least two business 
+  days before a final decision can be made.
+* Respondents may vote "+1" to indicate support for the proposal and a 
+  willingness to support implementation.
+* Respondents may vote "-1" to veto a proposal, but must provide clear 
+  reasoning and alternate approaches to resolving the problem within 
+  the two days.
+* A vote of -0 indicates mild disagreement, but has no effect.  A 0 
+  indicates no opinion.  A +0 indicate mild support, but has no 
+  effect.
+* Anyone may comment on proposals on the list, but only members of the 
+  Project Steering Committee's votes will be counted.
+* A proposal will be accepted if it receives +2 (including the 
+  author) and no vetoes (-1).
+* If a proposal is vetoed, and it cannot be revised to satisfy all 
+  parties, then it can be resubmitted for an override vote in which a 
+  majority of all eligible voters indicating +1 is sufficient to pass it.  
+  Note that this is a majority of all committee members, not just those who 
+  actively vote.
+* Upon completion of discussion and voting the author should announce 
+  whether they are proceeding (proposal accepted) or are withdrawing 
+  their proposal (vetoed).
+* The Chair gets a vote.
+* The Chair is responsible for keeping track of who is a member of the 
+  Project Steering Committee (perhaps as part of a PSC file in CVS).
+* Addition and removal of members from the committee, as well as selection 
+  of a Chair should be handled as a proposal to the committee.
+* The Chair adjudicates in cases of disputes about voting.
+ 
+When is Vote Required?
+-----------------------
 
-<p>There are two open committee positions at the initial formation of the PSC.<br /></p>
-</div>
+* Any change to committee membership (new members, removing inactive members)
+* Changes to project infrastructure (e.g. tool, location or substantive 
+  configuration)
+* Anything that could cause backward compatibility issues.
+* Adding substantial amounts of new code.
+* Changing inter-subsystem APIs, or objects.
+* Issues of procedure.
+* When releases should take place.
+* Anything dealing with relationships with external entities such as OSGeo
+* Anything that might be controversial.</li>
 
-<br /><br />
-<h3>Updates</h3>
-<div id="updates" class="section">
-<h3><a name="updates"></a></h3>
-<br /><br />
-<b>29 May 2007</b>
-<br /><br />
-<p>The following members were were added to the PSC after discussion and consensus:
- <ul>
-  <li>Tom Kralidis</li>
-  <li>Jeff McKenna</li>
-  <li>Umberto Nicoletti</li>
-  <li>Tamas Szekeres</li>
- </ul>
-</p>
-</div>
+Observations
+----------------
 
+* The Chair is the ultimate adjudicator if things break down.
+* The absolute majority rule can be used to override an obstructionist 
+  veto, but it is intended that in normal circumstances vetoers need to be 
+  convinced to withdraw their veto.  We are trying to reach consensus.
+* It is anticipated that separate "committees" will exist to manage 
+  conferences, documentation and web sites.  That said, it is expected 
+  that the PSC will be the entity largely responsible for creating any 
+  such committees.
+
+Committee Membership
+---------------------
+
+The PSC is made up of individuals consisting of technical contributors 
+(e.g. developers) and prominent members of the MapServer user community.  
+There is no set number of members for the PSC although the initial desire 
+is to set the membership at 9.
+
+Adding Members
+..............
+
+Any member of the mapserver-dev mailing list may nominate someone for 
+committee membership at any time. Only existing PSC committee members may 
+vote on new members.  Nominees must receive a majority vote from existing 
+members to be added to the PSC.
+
+Stepping Down
+.............
+
+If for any reason a PSC member is not able to fully participate then they 
+certainly are free to step down.  If a member is not active (e.g. no 
+voting, no IRC or email participation) for a period of two months then 
+the committee reserves the right to seek nominations to fill that position.
+Should that person become active again (hey, it happens) then they would 
+certainly be welcome, but would require a nomination.
+
+Membership Responsibilities
+-----------------------------
+
+Guiding Development
+    Members should take an active role guiding the development of new features 
+    they feel passionate about. Once a change request has been accepted 
+    and given a green light to proceed does not mean the members are free of 
+    their obligation. PSC members voting "+1" for a change request are 
+    expected to stay engaged and ensure the change is implemented and 
+    documented in a way that is most beneficial to users. Note that this 
+    applies not only to change requests that affect code, but also those 
+    that affect the web site, technical infrastructure, policies and standards.
+IRC Meeting Attendance
+    PSC members are expected to participate in pre-scheduled IRC development 
+    meetings. If known in advance that a member cannot attend a meeting, 
+    the member should let the meeting organizer know via e-mail.
+Mailing List Participation
+    PSC members are expected to be active on both the mapserver-users 
+    and mapserver-dev mailing lists, subject to open source mailing list 
+    etiquette. Non-developer members of the PSC are not expected to respond 
+    to coding level questions on the developer mailing list, however they 
+    are expected to provide their thoughts and opinions on user level 
+    requirements and compatibility issues when RFC discussions take place.
+
+Bootstrapping
+-----------------
+
+Prior to the TSC anointing itself the PSC this RFC must be distributed before 
+the MapServer community via MapServer-Users for comment. Any and all 
+substantive comments must be discussed (and hopefully, but not necessarily, 
+addressed via MapServer-Dev.
+
+All members of the existing Technical Steering Committee will form the initial 
+Project Steering Committee. Steve Lime is declared initial Chair of 
+the Project Steering Committee.
+
+Initial members are:
+
+
+* Steve Lime
+* Daniel Morissette
+* Frank Warmerdam
+* Assefa Yewondwossen
+* Howard Butler
+* Steve Woodbridge
+* Perry Nacionales
+
+There are two open committee positions at the initial formation of the PSC.
+
+Updates
+---------
+
+**29 May 2007**
+
+The following members were were added to the PSC after discussion and consensus:
+
+* Tom Kralidis
+* Jeff McKenna
+* Umberto Nicoletti
+* Tamas Szekeres
+
+



More information about the mapserver-commits mailing list