opendev/gerrit
Code Issues Proposed changes

Update documentation to clarify how to set Global Capabilities

Browse Source 
The documentation does not clearly state that the Global Capabilities
are set via the access rights of the root project (All-Projects).

Also the section in which the Global Capabilities are documented is
named "System Capabilities" which makes it harder to find by searching.

Change the name of the section, and add a clarification paragraph.

Change-Id: I46eaf1e81dfc4962f482571fe25b6a6a10e17b45
This commit is contained in:
David Pursehouse 2013-04-23 18:51:04 +09:00
parent 4467d2a098
commit d61c6eb312
2 changed files with 7 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
Documentation/access-control.txt
View File

@ -1021,11 +1021,11 @@ on `refs/for/refs/heads/<branch>` rather than permissions to upload changes
on `refs/heads/<branch>`. on `refs/heads/<branch>`.
[[system_capabilities]] [[global_capabilities]]
System capabilities Global Capabilities
------------------- -------------------
The system capabilities control actions that the administrators of The global capabilities control actions that the administrators of
the server can perform which usually affect the entire the server can perform which usually affect the entire
server in some way. The administrators may delegate these server in some way. The administrators may delegate these
capabilities to trusted groups of users. capabilities to trusted groups of users.
@ -1036,6 +1036,9 @@ administrative control of the server. This makes it possible to
keep fewer users in the administrators group, even while spreading keep fewer users in the administrators group, even while spreading
much of the server administration burden out to more users. much of the server administration burden out to more users.
Global capabilities are assigned to groups in the access rights settings
of the root project ("`All-Projects`").
Below you find a list of capabilities available: Below you find a list of capabilities available:

2
Documentation/rest-api.txt
View File

@ -112,7 +112,7 @@ if options are set which cannot be used together.
calling user has no sufficient permissions. calling user has no sufficient permissions.
E.g. some REST endpoints require that the calling user has certain E.g. some REST endpoints require that the calling user has certain
link:access-control.html#system_capabilities[global capabilities] link:access-control.html#global_capabilities[global capabilities]
assigned. assigned.
`403 Forbidden` is also used if `self` is used as account ID and the `403 Forbidden` is also used if `self` is used as account ID and the