# NAME

Dist::Zilla::Plugin::ContributorsFile - add a file listing all contributors

# VERSION

version 0.2.3

# SYNOPSIS

In dist.ini:

    " any plugin populating x_contributors in the META files
    [ContributorsFromGit]

    [ContributorsFile]
    filename = CONTRIBUTORS

# DESCRIPTION

`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).

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. 

# CONFIGURATION OPTIONS

## filename

The name of the contributor file that is created. Defaults to _CONTRIBUTORS_.

# TRICKS

Refer to David Golden's blog entry at 
[http://www.dagolden.com/index.php/1921/how-im-using-distzilla-to-give-credit-to-contributors/](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.

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](https://www.kernel.org/pub/software/scm/git/docs/git-shortlog.html).

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 "..."

# SEE ALSO

[Dist::Zilla::Plugin::ContributorsFromGit](https://metacpan.org/pod/Dist::Zilla::Plugin::ContributorsFromGit)

[http://p3rl.org/Pod::Weaver::Section::Contributors](http://p3rl.org/Pod::Weaver::Section::Contributors)

# AUTHOR

Yanick Champoux <yanick@cpan.org> [![endorse](http://api.coderwall.com/yanick/endorsecount.png)](http://coderwall.com/yanick)

# COPYRIGHT AND LICENSE

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.
