diff options
| author | Howard Butler <howard@hobu.co> | 2018-06-03 22:00:58 -0500 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2018-06-03 22:00:58 -0500 |
| commit | b357bf6b9df93efb860bbd472ec1aaed401bb8e2 (patch) | |
| tree | 6e49ced1f248d7b5d14aa7c5118785c29c0b65c1 /docs/source/community/rfc | |
| parent | 6160304480a2d16022662935da3837986cd2ba61 (diff) | |
| download | PROJ-b357bf6b9df93efb860bbd472ec1aaed401bb8e2.tar.gz PROJ-b357bf6b9df93efb860bbd472ec1aaed401bb8e2.zip | |
add RFC 1 -- initial creation of the PROJ Project Steering Committee (#1028)
* add RFC 1 -- initial creation of the PROJ Project Steering Committee
* fix up copypasta items from MapServer RFC
Diffstat (limited to 'docs/source/community/rfc')
| -rw-r--r-- | docs/source/community/rfc/index.rst | 14 | ||||
| -rw-r--r-- | docs/source/community/rfc/rfc-1.rst | 176 |
2 files changed, 190 insertions, 0 deletions
diff --git a/docs/source/community/rfc/index.rst b/docs/source/community/rfc/index.rst new file mode 100644 index 00000000..dc0332df --- /dev/null +++ b/docs/source/community/rfc/index.rst @@ -0,0 +1,14 @@ +.. _rfcs: + +***************************************************************************** + Request for Comments +***************************************************************************** + +A PROJ RFC describes a major change in the technological underpinnings of +PROJ, major additions to functionality, or changes in the direction of +the project. + +.. toctree:: + :maxdepth: 1 + + rfc-1 diff --git a/docs/source/community/rfc/rfc-1.rst b/docs/source/community/rfc/rfc-1.rst new file mode 100644 index 00000000..5836da1f --- /dev/null +++ b/docs/source/community/rfc/rfc-1.rst @@ -0,0 +1,176 @@ +.. _rfc1: + +==================================================================== +PROJ RFC 1: Project Committee Guidelines +==================================================================== + +:Author: Frank Warmerdam, Howard Butler +:Contact: howard@hobu.co +:Status: Proposed +:Last Updated: 2018-06-04 + +Summary +----------- + +This document describes how the PROJ Project Steering Committee (PSC) +determines membership, and makes decisions on all aspects of the +PROJ project - both technical and non-technical. + +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 PROJ software +* reviewing RFC for technical enhancements to the software +* project infrastructure (e.g. GitHub, continuous integration 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) + +In brief the project team votes on proposals on the `proj mailing list`_. 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. + +.. _`proj mailing list`: http://lists.maptools.org/mailman/listinfo/proj + +List of PSC Members +------------------- +(up-to-date as of 2018-06) + +* Kristian Evers `@kbevers <https://github.com/kbevers>`_ (DK) **Chair** +* Howard Butler `@hobu <https://github.com/hobu>`_ (USA) +* Charles Karney `@cffk <https://github.com/cffk>`_ (USA) +* Thomas Knudsen `@busstoptaktik <https://github.com/busstoptaktik>`_ (DK) +* Even Rouault `@rouault <https://github.com/rouault>`_ (FR) +* Kurt Schwehr `@schwehr <https://github.com/schwehr>`_ (USA) +* Frank Warmerdam `@warmerdam <https://github.com/warmerdam>`_ (USA) **Emeritus** + +Detailed Process +----------------------- + +* Proposals are written up and submitted on the `proj 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. + +RFC Origin +............. + +PROJ RFC and Project Steering Committee is derived from similar governance +bodies in both the `GDAL <https://trac.osgeo.org/gdal/wiki/rfc1_pmc>`__ and +`MapServer <http://mapserver.org/development/rfc/ms-rfc-23.html>`__ software +projects. + +When is Vote Required? +----------------------- + +* 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. + +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 PROJ user community. +There is no set number of members for the PSC although the initial desire +is to set the membership at 6. + +Adding Members +.............. + +Any member of the `proj 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. + +Mailing List Participation +............................... + +PSC members are expected to be active on the +`proj mailing list`_, 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. + + +Updates +--------- + +**June 2018** + +RFC 1 was ratified by the following members |
