doc: process: Fix heading levels

Fix and balance levels and move sub-sections to appropriate sections.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
This commit is contained in:
Anas Nashif 2021-04-28 08:03:46 -04:00
commit d48627b994

View file

@ -24,7 +24,7 @@ particular code base areas or subsystems.
Contributor Contributor
########### +++++++++++
A *Contributor* is a developer who wishes to contribute to the project, A *Contributor* is a developer who wishes to contribute to the project,
at any level. Contributors who show dedication and skill are rewarded with at any level. Contributors who show dedication and skill are rewarded with
@ -50,7 +50,7 @@ Contributors are granted the following rights and responsibilities:
(https://github.com/zephyrproject-rtos/zephyr/blob/master/CODE_OF_CONDUCT.md) (https://github.com/zephyrproject-rtos/zephyr/blob/master/CODE_OF_CONDUCT.md)
Collaborator Collaborator
############ ++++++++++++
A *Collaborator* is a Contributor who is also responsible for the maintenance A *Collaborator* is a Contributor who is also responsible for the maintenance
of Zephyr source code. Their opinions weigh more when decisions are made, in a of Zephyr source code. Their opinions weigh more when decisions are made, in a
@ -70,7 +70,7 @@ in addition to those listed for Contributors:
process, when those happen. process, when those happen.
Maintainer Maintainer
########## ++++++++++
A *Maintainer* is a Collaborator who is also responsible for knowing, A *Maintainer* is a Collaborator who is also responsible for knowing,
directing and anticipating the needs of a given zephyr source code area. directing and anticipating the needs of a given zephyr source code area.
@ -105,10 +105,10 @@ Role Retirement
Teams and Supporting Activities Teams and Supporting Activities
******************************* ###############################
Assignee Assignee
######## ++++++++
An *Assignee* is one of the maintainers of a subsystem or code being changed. An *Assignee* is one of the maintainers of a subsystem or code being changed.
Assignees are set either automatically based on the code being changed or set Assignees are set either automatically based on the code being changed or set
@ -125,7 +125,7 @@ the latter is not possible.
* Responsibility to drive the escalation process * Responsibility to drive the escalation process
Release Engineering Team Release Engineering Team
######################## ++++++++++++++++++++++++
A team of active Maintainers involved in multiple areas. A team of active Maintainers involved in multiple areas.
@ -161,13 +161,53 @@ Joining the Release Engineering team
geographically distributed across multiple locations and geographically distributed across multiple locations and
time-zones). time-zones).
Release Activity
################
.. figure:: img/img_release_activity.png Release Manager
:width: 663px +++++++++++++++
:align: center
:alt: Release Activity A *Maintainer* responsible for driving a specific release to
completion following the milestones and the roadmap of the
project for this specific release.
* TSC has to approve a release manager.
A Release Manager is a member of the Release Engineering team and has
the rights and responsibilities of that team in addition to
the following:
* Right to manage and coordinate all code merges after the
code freeze milestone (M3, see `program management overview <https://wiki.zephyrproject.org/Program-Management>`_.)
* Responsibility to drive and coordinate the triaging process
for the release
* Responsibility to create the release notes of the release
* Responsibility to notify all stakeholders of the project,
including the community at large about the status of the
release in a timely manner.
* Responsibility to coordinate with QA and validation and
verify changes either directly or through QA before major
changes and major milestones.
Roles / Permissions
+++++++++++++++++++
.. table:: Project Roles vs Github Permissions
:widths: 20 20 10 10 10 10 10
:align: center
================ =================== =========== ================ =========== =========== ============
.. .. **Admin** **Merge Rights** Member Owner Collaborator
---------------- ------------------- ----------- ---------------- ----------- ----------- ------------
Main Roles Contributor x
---------------- ------------------- ----------- ---------------- ----------- ----------- ------------
.. Collaborator x
---------------- ------------------- ----------- ---------------- ----------- ----------- ------------
.. Maintainer x
Supportive Roles QA/Validation x x
.. DevOps **x**
.. System Admin **x** x
.. Release Engineering **x** **x** x
================ =================== =========== ================ =========== =========== ============
MAINTAINERS File MAINTAINERS File
@ -222,8 +262,16 @@ Generic guidelines for deciding and filling in the Maintainers' list
implementation implementation
Release Activity
################
.. figure:: img/img_release_activity.png
:width: 663px
:align: center
:alt: Release Activity
Merge Criteria Merge Criteria
############## ++++++++++++++
* All continuous integration checks have passed * All continuous integration checks have passed
@ -260,7 +308,7 @@ Merge Criteria
* All required checks are passing * All required checks are passing
Escalation Process Escalation Process
################## ++++++++++++++++++
* Contributors may object to change requests or decisions made by * Contributors may object to change requests or decisions made by
Maintainers. Maintainers.
@ -280,51 +328,3 @@ Escalation Process
a binding resolution in the TSC. a binding resolution in the TSC.
* Assignee to ensure the resolution of the escalation is * Assignee to ensure the resolution of the escalation is
reflected in the PR review. reflected in the PR review.
Release Manager
###############
A *Maintainer* responsible for driving a specific release to
completion following the milestones and the roadmap of the
project for this specific release.
* TSC has to approve a release manager.
A Release Manager is a member of the Release Engineering team and has
the rights and responsibilities of that team in addition to
the following:
* Right to manage and coordinate all code merges after the
code freeze milestone (M3, see `program management overview <https://wiki.zephyrproject.org/Program-Management>`_.)
* Responsibility to drive and coordinate the triaging process
for the release
* Responsibility to create the release notes of the release
* Responsibility to notify all stakeholders of the project,
including the community at large about the status of the
release in a timely manner.
* Responsibility to coordinate with QA and validation and
verify changes either directly or through QA before major
changes and major milestones.
Roles / Permissions
###################
.. table:: Project Roles vs Github Permissions
:widths: 20 20 10 10 10 10 10
:align: center
================ =================== =========== ================ =========== =========== ============
.. .. **Admin** **Merge Rights** Member Owner Collaborator
---------------- ------------------- ----------- ---------------- ----------- ----------- ------------
Main Roles Contributor x
---------------- ------------------- ----------- ---------------- ----------- ----------- ------------
.. Collaborator x
---------------- ------------------- ----------- ---------------- ----------- ----------- ------------
.. Maintainer x
Supportive Roles QA/Validation x x
.. DevOps **x**
.. System Admin **x** x
.. Release Engineering **x** **x** x
================ =================== =========== ================ =========== =========== ============