aboutsummaryrefslogtreecommitdiff
path: root/docs/source/community/rfc
diff options
context:
space:
mode:
authorHoward Butler <howard@hobu.co>2018-06-03 22:00:58 -0500
committerGitHub <noreply@github.com>2018-06-03 22:00:58 -0500
commitb357bf6b9df93efb860bbd472ec1aaed401bb8e2 (patch)
tree6e49ced1f248d7b5d14aa7c5118785c29c0b65c1 /docs/source/community/rfc
parent6160304480a2d16022662935da3837986cd2ba61 (diff)
downloadPROJ-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.rst14
-rw-r--r--docs/source/community/rfc/rfc-1.rst176
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