Skip to content

Commit 80814fa

Browse files
committed
Add requirements and docs on maintainers' expectations
1 parent 55a1a01 commit 80814fa

2 files changed

Lines changed: 79 additions & 8 deletions

File tree

docs/02-for-app-authors/02-requirements.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,15 @@ binary formats hosted on a well-known host. The submission may be
129129
subject to additional scrutiny if it exhibits signs of poor structure,
130130
bad practices, instability, or obfuscation.
131131

132+
#### Trust and history
133+
134+
Submission decisions may take a submitter's prior conduct into account.
135+
136+
A pattern of policy violations, uncooperative behaviour, multiple
137+
abandoned or poorly maintained apps, misleading practices, or failure to
138+
address security and compliance issues may result in rejection of current
139+
or new submissions.
140+
132141
#### Misleading, malicious or illegal submissions
133142

134143
Submissions that impersonate; engage or encourage to engage in unlawful

docs/02-for-app-authors/06-maintenance.md

Lines changed: 70 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,76 @@ This is a guide on how to maintain an application once it is published
44
on Flathub. Some familiarity with Git, GitHub and Flatpak is required
55
to maintain an application.
66

7-
Please familiarize yourself with the repository layout, branch structure
8-
as discussed below. The workflow involves [submitting updates](/docs/for-app-authors/updates#creating-updates)
9-
or changes via pull requests and merging them when the build is successful
10-
and tested.
11-
12-
Maintainers should try to update the application's runtime whenever
13-
feasible and ensure that it does not rely on an end-of-life (EOL)
14-
runtime. They should also be aware of the [runtime support policies](/docs/for-app-authors/runtimes#currently-hosted-runtimes).
7+
## Requirements and expectations
8+
9+
_A **maintainer** refers to anyone responsible for maintaining an
10+
application, extension, runtime, or baseapp published on Flathub._
11+
12+
### Understanding limits
13+
14+
Developing and maintaining software can be demanding, and maintainers
15+
may at times face time constraints, burnout, or shifting priorities. In
16+
such cases, they may consider appointing co-maintainers, delegating
17+
responsibilities, or [reaching out to Flathub admins](/docs/for-app-authors/maintenance#getting-help)
18+
for help. Maintainers should also avoid submitting or maintaining more
19+
applications than they can reasonably manage within their capacity.
20+
21+
### Requirements
22+
23+
- Adhere to and comply with the Flathub policies (for example, the
24+
[requirements](/docs/for-app-authors/requirements)) that were in
25+
effect at the time their submission was accepted.
26+
27+
### Expectations
28+
29+
None of the expectations outlined below are strict requirements. They
30+
represent best practices intended to support long-term sustainability
31+
and provide a smooth, frictionless experience for everyone. However,
32+
persistent or repeated disregard for these expectations may
33+
influence submission reviews and, in some cases, lead to action being
34+
taken. For example, prolonged absence or an unmaintained state may
35+
result in pull requests being merged or the application being marked
36+
end-of-life (EOL) by a Flathub admin or trusted maintainer.
37+
38+
Current and prospective maintainers on Flathub are expected to:
39+
40+
- Be familiar with Git, GitHub, Flatpak, and `flatpak-builder`.
41+
42+
- Be able to build the application and its dependencies offline using
43+
`flatpak-builder`.
44+
45+
- Understand the Flathub repository layout and branch structure as
46+
discussed below.
47+
48+
- Follow the established [update workflow](/docs/for-app-authors/updates#creating-updates)
49+
which involves submitting updates and other changes via pull requests,
50+
and merging them only after successful builds and appropriate testing.
51+
52+
- Test the builds produced in pull requests before merging the pull
53+
request.
54+
55+
- Keep the runtime up to date where feasible, and avoid
56+
relying on end-of-life (EOL) runtimes in accordance with the
57+
[runtime support policies](/docs/for-app-authors/runtimes#currently-hosted-runtimes).
58+
59+
- Keep their submission in a functional, well-maintained state and
60+
be responsive to issues and pull requests.
61+
62+
- Be aware of Flathub policy changes and adapt to them when notified
63+
or requested.
64+
65+
- Mark the application as [end-of-life (EOL)](/docs/for-app-authors/maintenance#end-of-life)
66+
if development has ceased or the application is no longer functional.
67+
68+
- Understand that Flathub is largely run and managed by volunteers in
69+
their free time, and that much of the infrastructure is generously
70+
donated. Abuse of these resources should be avoided, and there should
71+
be no expectation of prioritized support or work.
72+
73+
- Stay engaged with the Flathub community through available channels,
74+
including the [Flathub Discourse](https://discourse.flathub.org/), the
75+
[Flathub blog](https://docs.flathub.org/blog), and the
76+
[Flathub Matrix channel](https://matrix.to/#/#flathub:matrix.org).
1577

1678
## The repository
1779

0 commit comments

Comments
 (0)