Skip to content

Commit 76c0ee0

Browse files
authored
Add FAQ entry to explain module adoptions #2431 (#2432)
* Add FAQ entry to explain module adoptions #2431
1 parent a64bff1 commit 76c0ee0

File tree

1 file changed

+40
-0
lines changed

1 file changed

+40
-0
lines changed

root/about/faq.html

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -151,6 +151,46 @@
151151
The PAUSE account information need to be updated manually via
152152
[Edit Account Info](https://pause.perl.org/pause/authenquery?ACTION=edit_cred).
153153

154+
## How to adopt a distribution?
155+
156+
### What does the "Take me over?", "Why not adopt me?", "Looking for help!" mean?
157+
158+
CPAN Distributions can be marked by their authors (or by the CPAN admins when the author is not available)
159+
to be "up for adoption". This can be done by adding one of the following PAUSE accounts
160+
as co-maintainers: ADOPTME, HANDOFF, or NEEDHELP. For a more detailed explanation
161+
read the post [Marking modules as 'available for adoption'](http://neilb.org/2013/08/07/adoptme.html).
162+
163+
164+
### How to become the maintainer or co-maintainer of a CPAN distribution?
165+
166+
See the description how to [adopt a CPAN module](http://neilb.org/2013/07/24/adopt-a-module.html)
167+
and check out the [CPAN adoption request template](http://neilb.org/2014/01/31/adoption-request.html).
168+
169+
See also the list of [CPAN Adoption Candidates](https://neilb.org/adoption/).
170+
171+
### How to mark a distribution that is up for adoption?
172+
173+
If you are the maintainer of the distribution you can follow these steps:
174+
175+
* Visit [PAUSE](https://pause.perl.org/)
176+
* Click on "Add Comaintainers"
177+
* Filter for the name of the distribution.
178+
* Check the box next to the name of the distribution.
179+
* Type in HANDOFF as userid.
180+
* Click on "Make Co-Maintainer"
181+
* Within an hour the change will show up on MetaCPAN.
182+
183+
### How to remove the "adopt me" banner from the module?
184+
185+
Remove the author ADOPTME, HANDOFF, or NEEDHELP from the project.
186+
187+
* Visit [PAUSE](https://pause.perl.org/)
188+
* Click on "Remove Comaintainers".
189+
* Filter for the name of the distribution.
190+
* Check which one of the above 3 are listed.
191+
* Select them and click on "Remove".
192+
* Within an hour the change will show up on MetaCPAN.
193+
154194
<% END %>
155195

156196
</div>

0 commit comments

Comments
 (0)