From 9bfe5a6eb85ff494018111a1ae4ca83acae1726e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pablo=20Correa=20G=C3=B3mez?= Date: Mon, 6 May 2024 13:36:24 +0200 Subject: [PATCH] for-team-members: add info on what they are and how to become one --- .../02-becoming-a-team-member.md | 42 +++++++++++++++++++ .../{02-review.md => 03-review.md} | 0 ...cs-guidelines.md => 04-docs-guidelines.md} | 0 3 files changed, 42 insertions(+) create mode 100644 docs/03-for-team-members/02-becoming-a-team-member.md rename docs/03-for-team-members/{02-review.md => 03-review.md} (100%) rename docs/03-for-team-members/{03-docs-guidelines.md => 04-docs-guidelines.md} (100%) diff --git a/docs/03-for-team-members/02-becoming-a-team-member.md b/docs/03-for-team-members/02-becoming-a-team-member.md new file mode 100644 index 00000000..fb43a26e --- /dev/null +++ b/docs/03-for-team-members/02-becoming-a-team-member.md @@ -0,0 +1,42 @@ +# Team members + +Flathub, as a centralized repository of software apps, has a dedicated team of +contributors necessary to keep it running. These contributors are in charge of: + +* Reviewing new applications +* Reviewing permission changes for existing aplications +* Requesting permission changes for existent apps that might not fit the + guidelines + +In consequence, they can be seen as the auditors and moderators of our +community. As such, they play a big role in the decision-making process. +They are also an important part of the Flathub and Flatpak trust model. The fact +that applications permissions are audited by the community is a warranty to +consistent and safe permissions in the majority of the cases. Therefore, we they +also enjoy the recognition for their work! + +## Becoming a team member + +Since auditing apps and permissions is a great task, we are always in need of +more hands. If you want to be part of our team, help out and enjoy the benefits, +simply follow these steps: + +* Engage with the community, so that other team members can know you. +* Help review [pending applications](https://github.com/flathub/flathub/pulls) + so that they match the + [requirements](https://docs.flathub.org/docs/for-app-authors/requirements). + You don't need to be a team member to do so, more eyes are always welcomed, + and that way you can prove your interest and ability to carry the reviews. + As with everything, there is always a learning curve, so the recommendation is + to start small and listen to the feedback of existing team members. + TODO: For how long should have people contributed? How many apps should they + have reviewed? +* Review current apps to request and update permissions access. + TODO: Is there a public place where this is done that people can contribute + to? Or maybe just look at some existing apps? +* Open an issue in this repo, listing your contributions and why you want you + become a member. + TODO: Maybe in the flathub repo? An issue template could help? +* You need at least 2 team members to endorse you becoming part of the team, + so it is recommended that you have talked and collaborated with them before, + so that they are aware of your work and the benefit of having you on board. diff --git a/docs/03-for-team-members/02-review.md b/docs/03-for-team-members/03-review.md similarity index 100% rename from docs/03-for-team-members/02-review.md rename to docs/03-for-team-members/03-review.md diff --git a/docs/03-for-team-members/03-docs-guidelines.md b/docs/03-for-team-members/04-docs-guidelines.md similarity index 100% rename from docs/03-for-team-members/03-docs-guidelines.md rename to docs/03-for-team-members/04-docs-guidelines.md