[GitHub] [comdev-site] rbowen commented on a diff in pull request #102: Best practice docs for PMCs, etc

["rbowen (via GitHub)" <gi...@apache.org>]

rbowen commented on code in PR #102:
URL: https://github.com/apache/comdev-site/pull/102#discussion_r1172804091


##########
source/pmc/_index.md:
##########
@@ -0,0 +1,72 @@
+---
+title: Project Management Committees
+---
+
+The Project Management Committee, or PMC, is the technical steering
+committee for a project. This group determines the roadmap for the
+project, decides who will be added as committers and PMC members, and
+reports quarterly to the Board of Directors.
+
+* [PMC Responsibilities](#pmc-responsibilities)
+* [Chair](#chair)
+* [Voting](#voting)
+* [Reporting](#reporting)
+* [Adding new committers](#adding-new-committers)
+* [Adding new PMC members](#adding-new-pmc-members)
+* [What to do as a new member](#what-to-do-as-a-new-member)
+
+## PMC Responsibilities
+
+The PMC is responsible for the management of the project. This includes
+both the technical decisions, and ensuring that the project is operating
+in community-friendly ways.
+
+The PMC is also responsibile for voting on releases of their project, to
+ensure that each release is tested, and is an official ASF release
+artifact.
+
+[Read more about PMC responsibilities](/pmc/responsibilities)
+
+
+## Chair
+
+The PMC Chair acts as the voice of the project to the board, and is
+responsibile for filing a quarterly report. They are not the project
+leader, but are a peer of the other PMC members, who has been selected,
+for a time, to take the role of secretary and spokesperson.
+
+[Read more about the PMC Chair](/pmc/chair)
+
+## Voting
+
+While most actions of a project are decided by discussion and consensus,
+there are a number of situations in which a vote is necessary. You can
+read more about voting on the [ASF main
+website](https://apache.org/foundation/voting.html).
+
+## Reporting
+
+A PMC is required to file a report to the Board of Directors every
+quarter, on a schedule determined by the Board. [Read more about what
+goes into a PMC report](/pmc/reporting).
+
+## Adding new committers
+
+The addition of new committers is essential to the long-term 
+sustainability of an open source project. The PMC is responsible for
+determining who will be added as a committer. [Read more about how new
+committers are added to a project](/pmc/adding-committers).
+
+
+## Adding new PMC members
+
+The PMC members identify project participants who they want to be
+members of the PMC. [Read more about the process of adding new PMC
+members](/pmc/adding-pmc-members).
+
+## What to do as a new member
+
+If you've just been added as a new PMC member, there's a number of
+things that you'll need to do to be an effective part of the PMC. [Read
+more about getting started as a new PMC member](/pmc/new-member).

Review Comment:
   No, I don't think so. the (...) in this is markdown syntax for a link, not punctuation. So the period correctly goes outside of that paren.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@community.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@community.apache.org
For additional commands, e-mail: dev-help@community.apache.org