From 9332ffcddd8270bf51f2681360860ebdf9cfe7d0 Mon Sep 17 00:00:00 2001 From: classabbyamp Date: Sun, 23 Jul 2023 11:03:01 -0400 Subject: [PATCH] CONTRIBUTING.md: describe adoption/orphaning policy and procedure --- CONTRIBUTING.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index a8f58bbb37445..52ca1b18b48ff 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -82,6 +82,25 @@ The checksum can be updated automatically with the `xgensum` helper from the [xt $ xgensum -i +### Adopting a template + +If a template is orphaned (maintained by `orphan@voidlinux.org`) or the current `maintainer` has not contributed in a long +time (over a year), template maintainership can be adopted by someone else. To ensure a template gets the care it needs, +template adopters should use the package in question and have a history of contributing changes to that template (updating +the template several times, for example). + +It is best to adopt a template when making another change to it. When adopting the template, add your name or username +and email to the `maintainer` field in the template, and mention the adoption in your commit message, for example: + + libfoo: update to 1.2.3, adopt. + +### Orphaning a template + +If you no longer wish to maintain a template, you can remove yourself as maintainer by setting the `maintainer` field in +the template to `Orphaned `. The commit message should mention this, for example: + + libfoo: update to 1.2.3, orphan. + ### Committing your changes After making your changes, please check that the package builds successfully. From the top level directory of your local copy of the `void-packages` repository, run: