Skip to content

Commit 9fa852b

Browse files
committed
Add docs on "Becoming a Flathub Team Member"
1 parent b4e6fc0 commit 9fa852b

1 file changed

Lines changed: 114 additions & 0 deletions

File tree

Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
# Becoming a Flathub Team Member
2+
3+
Flathub, as a centralized application repository, relies on a dedicated
4+
team of mainly volunteer contributors to maintain the quality, security,
5+
and consistency of the repository.
6+
7+
These contributors are generally responsible for tasks including, but
8+
not limited to:
9+
10+
* Reviewing new application submissions.
11+
* Reviewing moderation requests, such as permission changes.
12+
* Triaging and responding to issues or queries from application
13+
developers.
14+
* Updating, adopting maintenance of, or contributing to Flatpaks when
15+
necessary.
16+
* Auditing existing applications to ensure compliance with current
17+
Flathub guidelines and best practices.
18+
19+
As Flathub continues to grow, the associated workload also increases.
20+
So, expanding the contributor base helps distribute this workload more
21+
effectively and improves sustainability for the project overall.
22+
23+
## Team Membership Process
24+
25+
Please open an issue in <INSERT META REPO> linking relevant activity
26+
and/or contributions and wait for at least one existing project members
27+
to approve the request and grant the necessary permissions.
28+
29+
Please note that all approval requests are evaluated on a case-by-case
30+
basis and may take additional factors into consideration and may be
31+
denied.
32+
33+
## Membership Criteria
34+
35+
### Reviewer Team
36+
37+
Members in the Reviewer Team are primarily responsible for reviewing,
38+
approving and merging new submissions.
39+
40+
Criteria:
41+
42+
* Past examples of performing non-trivial application submission
43+
reviews, with at least 3 successful reviews within the last 1 month
44+
that resulted in accepted submissions.
45+
* Familiarity with review policies and Flathub requirements.
46+
47+
### Trusted Maintainer Team
48+
49+
Members of the Trusted Maintainer Team are granted access to all
50+
Flathub submission repositories, including relevant access to the
51+
developer portal in the website.
52+
53+
They are primarily responsible for assisting with the maintenance and
54+
continuity of Flatpaks in situations where the original maintainer is
55+
unavailable or unresponsive.
56+
57+
Criteria:
58+
59+
* Experience maintaining at least 2 Flatpaks in Flathub GitHub
60+
repositories.
61+
* Past examples of assisting with package adoption, co-maintenance, or
62+
maintenance efforts with adherence to proper maintenance practices.
63+
* Familiarity with Flatpak, Flathub workflows, and related tooling.
64+
65+
### Build Moderation Team
66+
67+
Members of the Build Moderation Team are responsible for reviewing build
68+
and moderation requests, approving or denying them as appropriate, and
69+
providing clarification or follow-up when developers raise questions.
70+
71+
Criteria:
72+
73+
* Membership in either the Reviewer Team or Trusted Maintainer Team for
74+
a reasonable period of time.
75+
* Familiarity with moderation policies and Flatpak permission system.
76+
77+
### `flathub-infra` repositories
78+
79+
Most of the tooling and infrastructure used by Flathub is maintained in
80+
the `flathub-infra` organisation.
81+
82+
Access to the repositories there is granted based on demonstrated
83+
contributions to the relevant project for a reasonable period of time
84+
through all of pull requests, reviews, issue triaging, and familiarity
85+
with the associated project and its workflows.
86+
87+
Access will initially be limited to the triage or write permission and
88+
may later be expanded based on requirements and continued maintenance
89+
activity.
90+
91+
### `shared-modules` repository
92+
93+
This repository contains manifests for commonly used Flatpak modules
94+
that can be consumed as a git submodule.
95+
96+
Write access is granted to contributors willing to maintain one or
97+
more modules in the repository and the access may be revoked if the
98+
contributor no longer maintains the relevant modules or if those modules
99+
are removed from the repository.
100+
101+
## Revocation of Team Membership
102+
103+
In the event of prolonged inactivity, team membership may be revoked.
104+
105+
Inactivity is defined as the absence of any meaningful activity in the
106+
relevant GitHub repositories or namespaces for a period exceeding one
107+
year.
108+
109+
Before revocation, the concerned member must be notified through a
110+
GitHub issue in the <INSERT META REPO> and must be given up to one
111+
month to respond or resume activity.
112+
113+
Existing members may also request voluntary removal from the team by
114+
following the same process.

0 commit comments

Comments
 (0)