Dist::Zilla::Plugin::ContributorsFile - add a file listing all contributors
version 0.2.1
In dist.ini:
" any plugin populating x_contributors in the META files [ContributorsFromGit] [ContributorsFile] filename = CONTRIBUTORS
Dist::Zilla::Plugin::ContributorsFile populates a CONTRIBUTORS file with all the contributors of the project as found by Dist::Zilla::Plugin::ContributorsFromGit (or any other plugin populating the x_contributors in the META files).
Dist::Zilla::Plugin::ContributorsFile
Dist::Zilla::Plugin::ContributorsFromGit
The generated file will look like this:
# FOO-BAR CONTRIBUTORS # This is the (likely incomplete) list of people who have helped make this distribution what it is, either via code contributions, patches, bug reports, help with troubleshooting, etc. A huge thank to all of them. * Albert Zoot <zoo@foo.com> * Bertrand Maxwell <maxwell@bar.com>
Note that if no contributors beside the actual author(s) are found, the file will not be created.
The name of the contributor file that is created. Defaults to CONTRIBUTORS.
Refer to David Golden's blog entry at http://www.dagolden.com/index.php/1921/how-im-using-distzilla-to-give-credit-to-contributors/ to get introduced to the Dist::Zilla contributor modules.
Dist::Zilla
Git's .mailmap file is useful to deal with contributors with several email addresses: https://www.kernel.org/pub/software/scm/git/docs/git-shortlog.html.
.mailmap
To give credit to bug reporters and other persons who don't commit code directly, you can use empty git commits:
git commit --allow-empty --author="David Golden <dagolden@cpan.org>" -m "..."
http://p3rl.org/Pod::Weaver::Section::Contributors
Yanick Champoux <yanick@cpan.org>
This software is copyright (c) 2013 by Yanick Champoux.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install Dist::Zilla::Plugin::ContributorsFile, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Dist::Zilla::Plugin::ContributorsFile
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::Plugin::ContributorsFile
For more information on module installation, please visit the detailed CPAN module installation guide.