Skip to content

Commit 00fbdfa

Browse files
Document web application admin (#2146)
Signed-off-by: David A. Wheeler <[email protected]>
1 parent e51c24c commit 00fbdfa

File tree

1 file changed

+29
-0
lines changed

1 file changed

+29
-0
lines changed

docs/governance.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -156,6 +156,35 @@ Committers can accept contributions from contributors.
156156
Contributors are those who choose to contribute to the project.
157157
See [CONTRIBUTING](../CONTRIBUTING.md).
158158

159+
## Web application admin
160+
161+
A very few people have been granted the admin privilege within the
162+
web application. In general, the TSC and/or technical lead initiates
163+
inviting someone to have this admin privilege, it's usually not granted
164+
on request.
165+
Admin privilege is only considered for those who have consistently demonstrated
166+
(1) trustworthiness, (2) support for the badge project, and
167+
(3) need for this privilege (e.g., through repeated reasonable requests
168+
that we have to act on).
169+
170+
The admin privilege in the web application allows that user to
171+
edit/update any badge entry or user data, as well as see all this data.
172+
Note that we *do* keep a record of every change made to badge entry
173+
data and who made the change, even for admins.
174+
175+
The purpose of granting admin privilege is to
176+
enable that individual to immediately fix *any* of the issues
177+
in the badges or users. We recommend that admins fix projects so that
178+
individual projects can fix their own problems in the future.
179+
180+
Admin is a position of high trust. In particular, admins must not
181+
abuse their access to the email addresses of every user (which are
182+
private). We don't want to have many admins.
183+
However, we also don't want any one person to be a bottleneck.
184+
185+
Note that web application admin is not the same as having direct
186+
access/control over the underlying database or container.
187+
159188
## Process
160189

161190
We generally use the GitHub issue tracker and pull requests for managing

0 commit comments

Comments
 (0)