From d99b49109922064f415ef70f8a24a8dc45f082f6 Mon Sep 17 00:00:00 2001 From: Otto Urpelainen Date: Sep 18 2021 07:44:28 +0000 Subject: Update contribution guidelines Resolves #23 --- diff --git a/README.md b/README.md index d139f4f..d97538c 100644 --- a/README.md +++ b/README.md @@ -32,21 +32,34 @@ This repository attempts to follow the following: * Prefer `https://example.com[here]` over `link:https://example.com[here]` * Prefer `[#some-ref]` over `[[some-ref]]` -### Pull requests +### Submitting changes -All changes to the documentation is intended to happen through pull requests. -However, following the spirit of earlier wiki based documentation, -the documentation is intended to be maintainer collectively +The documentation is intended to be maintained collectively by all Fedora packagers. +Trivial changes, such as adding links or correcting typos, +can be committed directly to the `master` branch. +More substantial changes should be submitted through pull requests +and be reviewed by another contributor before merging. + Due to [technical issues][issue], -the `packager` group from Fedora Account System cannot be granted access, -so there is a separate group [package-maintainer-docs][group] with commit access. -Membership is granted to any packager requesting it. -Please file an issue in the repository if you want to join. +the `packager` group from the Fedora Account System cannot be granted access, +so there is a dedicated Pagure group [package-maintainer-docs][group] with commit access. +Membership is granted to authors of all merged pull request. +Membership can also be requested by commenting on [issue #23][23]. [issue]: https://pagure.io/releng/issue/9927 [group]: https://pagure.io/group/package-maintainer-docs +[23]: https://pagure.io/fedora-docs/package-maintainer-docs/issue/23 + +In case a pull request not reviewed in reasonable time, +the following actions can be taken, in given order: + +* Ask admins of this repository to take a look + by tagging them on the pull reuqest. +* Ask on the [devel mailing list][devel] why this repository is not responsive. + +[devel]: https://lists.fedoraproject.org/archives/list/devel@lists.fedoraproject.org/ ### Local preview