diff --git a/Documentation/access-control.txt b/Documentation/access-control.txt index 70d645d12a..30a6c39dd6 100644 --- a/Documentation/access-control.txt +++ b/Documentation/access-control.txt @@ -805,6 +805,42 @@ Suggested access rights to grant: * <> with range '-1' to '+1' +[[examples_developer]] +Developer +~~~~~~~~~ + +This is the typical core developer on a public server. They are able +to read the project, upload changes to a branch. They are allowed to +push merge commits to merge branches together. Also, they are allowed +to forge author identity, thus handling commits belonging to others +than themselves, effectively allowing them to transfer commits +between different branches. + +They are furthermore able to code review and verify commits, and +eventually submit them. If you have an automated CI system that +builds all uploaded patch sets you might want to skip the +verification rights for the developer and let the CI system do that +exclusively. + +Suggested access rights to grant: + +* <> on 'refs/heads/\*' and 'refs/tags/*' +* <> to 'refs/for/refs/heads/\*' and 'refs/changes/*' +* <> to 'refs/for/refs/heads/\*' and 'refs/changes/*' +* <> +* <> with range '-2' to '+2' +* <> with range '-1' to '+1' +* <> + +If the project is small or the developers are seasoned it might make +sense to give them the freedom to push commits directly to a branch. + +Optional access rights to grant: + +* <> to 'refs/heads/*' +* <> to 'refs/heads/*' + + [[conversion_table]] Conversion table from 2.1.x series to 2.2.x series --------------------------------------------------