feat(devmanual): Document app maintainer role

Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>
This commit is contained in:
Christoph Wurst
2023-04-17 19:16:21 +02:00
parent bef3457412
commit 7edb57e594
2 changed files with 36 additions and 0 deletions

View File

@@ -2,9 +2,12 @@
App publishing and maintenance
==============================
Transforming source files into a deliverable is documented in the :ref:`app-release-process`.
.. toctree::
:maxdepth: 2
maintainer
release_process
Publishing App on the App Store <https://nextcloudappstore.readthedocs.io/en/latest/developer.html>
publishing

View File

@@ -0,0 +1,33 @@
.. _app-maintainer:
===========
Maintainers
===========
.. sectionauthor:: Christoph Wurst <christoph@winzerhof-wurst.at>
The role of a Nextcloud app maintainer is to oversee all processes around an app. The responsibilities are:
* Triage bug reports
+ Make sure reported bugs are reproducible, ask for more info if necessary
+ Check for duplicates
+ Close resolved tickets
* Manage pull requests
+ Ensure pull request receive a review in reasonable time
+ Merge pull requests that pass the peer review and all continuous integration checks
+ Trigger backports if applicable
* Manage releases
+ Ensure pre-releases are ready for deployment in pre-production of Nextcloud server
+ Ensure compatible releases are ready for deployments of Nextcloud server releases
* Manage vulnerabilities
+ Monitor vulnerable dependencies, e.g. through Github security alerts, and release updates timely
+ Coordinate disclosed vulnerabilities with the Nextcloud security team
To avoid the so called `bus factor <https://en.wikipedia.org/wiki/Bus_factor>`_, it is highly recommended to have more than one maintainer for each app. Apps can have one primary maintainer and one or more backup maintainers. For transparency, it can make sense to declare the maintainers of an app in the app's repository README file, so that others know whom to contact.