Gentoo Developer Relations Undertakers
The Developer Relations Undertakers project handles developer retirement, both
when developers announce their retirement as well as due to developer
All developers can be reached by e-mail using firstname.lastname@example.org.
Steps to retire a developer
- Check CVS and bugzilla activity:
The easiest way to check developer's CVS activity is to go to the
http://cia.vc/stats/author/developer page. For example:
Another method involves using the history subcommand of cvs,
which will display you the activity of the developer in question across
all CVS repositories. Use it like this: cvs history -c -u dev | sort |
Additionally we have the CVS slacker report mails from stork (aka
cvs.gentoo.org) to email@example.com the 1st of every month
to see the last few bugzilla activities. Activity is defined very broadly
in this case so commenting, changing resolution, CC'ing etc. all count as
activity. You need to look at each of those bugs to decide if the activity
is related to development.
Try talking to the project lead(s), if the developer looks inactive. He
might be active in ways we can't determine easily. Put in some effort to
contact the developer (either IRC or via email) before starting the actual
retirement process. When sending an email to the developer in question, make
sure you tell him, that he might get retired due to being inactive. Also,
whenever sending emails in undertakers business, CC
If you believe developer is inactive, reopen the New Developer bug. If the
developer predates recruitment bugs (there was no recruitment bug), open a
new bug for retirement purposes. Change Summary to Retire: Full
Name (nickname). Reassign the bug to firstname.lastname@example.org
(Retirement Admin) and change Status Whiteboard to
first-mail-sent: yy-mm-dd. Make sure the developer is CC'ed on
Send him the first mail and
wait a minimum of two weeks, to give the developer adequate time to respond
on the bug or to the mail. If you get no response during that period, send
mail. Don't forget to change Status Whiteboard to
second-mail-sent and to update the date there. Remember that
email@example.com must be CC'ed on both mails and all responses
must be forwarded there.
Consider any responses carefully. We're supposed to help Gentoo (in this
case by keeping the developer base "clean"), not to retire as many
developers as possible.
- Close the bug if the developer is still considered active
If the developer doesn't respond in the given time or is otherwise still
considered inactive, state that on the bug and ask Infra to start retirement
process). Also make sure you change the Status Whiteboard to
Retirement procedure looks like this:
Wait for Infrastructure, Planet and Forums admins to retire developer in
question before proceeding further.
Remove access to #gentoo-dev (access is either removed completely
or changed to voice depending on whether they ask for it or they're still
considered active and helpful in the channel). Ask a freenode staffer to
reset the cloak to a non-gentoo one.
Clean up the tree and herds from the yet-retired developer. Use the
retire.py script (which is available in gentoo/xml/htdocs/proj/en/devrel/undertakers/scripts/)
for that purpose, but make sure to review its output before
Clean up any metadata.xml the developer in question might be
mentioned in. This is accomplished by running retire.py --metadata dev
/path/to/gentoo-x86. Review the output, and apply it to current CVS,
but make sure you cvs up before applying it.
Clean up herds.xml in proj/en/metastructure/herds/.
Remove the developer in question from any herds he might be listed in. To
find those, you might want to run this: retire.py --herds
/path/to/userinfo.xml /path/to/herds.xml. That will show you the
developers listed as retired in userinfo.xml which are still
listed in herds.xml.
Clean up any project pages the developer may be listed in. Just make sure
you don't erase them completely (for example
userrel/archives/soc/ is fine). Use retire.py --project
/path/to/userinfo.xml /path/to/xml/proj/en/ to find any stale
Search for all NEW and REOPEN bugs assigned to the retired developer on
Gentoo Bugzilla and reassign them to herds or projects the package
belongs to. Information to whom reassign can be obtained from
Metadata.xml file of that package.
- Close the bug once all of the above steps are finished!