@@ -4,14 +4,76 @@ This is a guide on how to maintain an application once it is published
44on Flathub. Some familiarity with Git, GitHub and Flatpak is required
55to 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