ansible/docs/docsite/rst/community/github_admins.rst

.. _github_admins:

*************
GitHub Admins
*************

.. contents:: Topics

GitHub Admins have more permissions on GitHub than normal contributors or even committers.  There are
a few responsibilities that come with that increased power.


Adding and removing committers
==============================

The Ansible Team will periodically review who is actively contributing to Ansible to grant or revoke
contributors' ability to commit on their own.  GitHub Admins are the people who have the power to
actually manage the GitHub permissions.


Changing branch permissions for releases
========================================

When we make releases we make people go through a :ref:`release_managers` to push commits to that
branch.  The GitHub admins are responsible for setting the branch so only the Release Manager can
commit to the branch when the release process reaches that stage and later opening the branch once
the release has been made.  The Release manager will let the GitHub Admin know when this needs to be
done.

.. seealso:: The `GitHub Admin Process Docs
    <https://docs.google.com/document/d/1gWPtxNX4J39uIzwqQWLIsTZ1dY_AwEZzAd9bJ4XtZso/edit#heading=h.2wezayw9xsqz>`_ for instructions
    on how to change branch permissions.
Docs reorg /community/index & /dev_guide/index (#48734) * Improved community/index.rst makes it easier to find existing content 2018-11-26 19:00:26 +00:00			`.. _github_admins:`

Remove more docs build errors (#45364) * orphans testing pages to avoid not-in-toctree errors * orphans various pages pending reorg * adds module_utils and special_vars to main TOC * uses a glob for scenario_guide TOC * normalize and Sentence-case headings on community pages, typos * re-orgs community TOC, adds all pages to toctree * removes scenario guides index page * adds style guide to community index * basic update to style guide * fix typo that created a new error * removes not-in-toctree from ignore errors list * leave removing files for future cleanup task 2018-09-11 16:51:47 +00:00			`*************`
Documentation on how to make a release. (#31426) * Release Engineering Docs with pointer to the Docs on how to actually make the release. 2017-12-21 16:14:49 +00:00			`GitHub Admins`
Remove more docs build errors (#45364) * orphans testing pages to avoid not-in-toctree errors * orphans various pages pending reorg * adds module_utils and special_vars to main TOC * uses a glob for scenario_guide TOC * normalize and Sentence-case headings on community pages, typos * re-orgs community TOC, adds all pages to toctree * removes scenario guides index page * adds style guide to community index * basic update to style guide * fix typo that created a new error * removes not-in-toctree from ignore errors list * leave removing files for future cleanup task 2018-09-11 16:51:47 +00:00			`*************`
Documentation on how to make a release. (#31426) * Release Engineering Docs with pointer to the Docs on how to actually make the release. 2017-12-21 16:14:49 +00:00
			`.. contents:: Topics`

Remove more docs build errors (#45364) * orphans testing pages to avoid not-in-toctree errors * orphans various pages pending reorg * adds module_utils and special_vars to main TOC * uses a glob for scenario_guide TOC * normalize and Sentence-case headings on community pages, typos * re-orgs community TOC, adds all pages to toctree * removes scenario guides index page * adds style guide to community index * basic update to style guide * fix typo that created a new error * removes not-in-toctree from ignore errors list * leave removing files for future cleanup task 2018-09-11 16:51:47 +00:00			`GitHub Admins have more permissions on GitHub than normal contributors or even committers. There are`
Documentation on how to make a release. (#31426) * Release Engineering Docs with pointer to the Docs on how to actually make the release. 2017-12-21 16:14:49 +00:00			`a few responsibilities that come with that increased power.`


Remove more docs build errors (#45364) * orphans testing pages to avoid not-in-toctree errors * orphans various pages pending reorg * adds module_utils and special_vars to main TOC * uses a glob for scenario_guide TOC * normalize and Sentence-case headings on community pages, typos * re-orgs community TOC, adds all pages to toctree * removes scenario guides index page * adds style guide to community index * basic update to style guide * fix typo that created a new error * removes not-in-toctree from ignore errors list * leave removing files for future cleanup task 2018-09-11 16:51:47 +00:00			`Adding and removing committers`
			`==============================`
Documentation on how to make a release. (#31426) * Release Engineering Docs with pointer to the Docs on how to actually make the release. 2017-12-21 16:14:49 +00:00
			`The Ansible Team will periodically review who is actively contributing to Ansible to grant or revoke`
			`contributors' ability to commit on their own. GitHub Admins are the people who have the power to`
			`actually manage the GitHub permissions.`


Remove more docs build errors (#45364) * orphans testing pages to avoid not-in-toctree errors * orphans various pages pending reorg * adds module_utils and special_vars to main TOC * uses a glob for scenario_guide TOC * normalize and Sentence-case headings on community pages, typos * re-orgs community TOC, adds all pages to toctree * removes scenario guides index page * adds style guide to community index * basic update to style guide * fix typo that created a new error * removes not-in-toctree from ignore errors list * leave removing files for future cleanup task 2018-09-11 16:51:47 +00:00			`Changing branch permissions for releases`
			`========================================`
Documentation on how to make a release. (#31426) * Release Engineering Docs with pointer to the Docs on how to actually make the release. 2017-12-21 16:14:49 +00:00
Doc build warning/broken link clean-a-palooza (#37382) * Doc build warning/broken link clean-a-palooza, WIP commit 1. * Fixed broken anchor * Fixing additional broken links; converting from doc to ref. * Fix anchor 2018-03-14 19:44:21 +00:00			When we make releases we make people go through a :ref:`release_managers` to push commits to that
Documentation on how to make a release. (#31426) * Release Engineering Docs with pointer to the Docs on how to actually make the release. 2017-12-21 16:14:49 +00:00			`branch. The GitHub admins are responsible for setting the branch so only the Release Manager can`
			`commit to the branch when the release process reaches that stage and later opening the branch once`
			`the release has been made. The Release manager will let the GitHub Admin know when this needs to be`
			`done.`

			.. seealso:: The `GitHub Admin Process Docs
Update link to GitHub admin process (#42364) 2018-07-05 19:38:52 +00:00			<https://docs.google.com/document/d/1gWPtxNX4J39uIzwqQWLIsTZ1dY_AwEZzAd9bJ4XtZso/edit#heading=h.2wezayw9xsqz>`_ for instructions
Documentation on how to make a release. (#31426) * Release Engineering Docs with pointer to the Docs on how to actually make the release. 2017-12-21 16:14:49 +00:00			`on how to change branch permissions.`