Dist::Zilla::PluginBundle::Author::AJNN::Readme - Build a README file for AJNN's distributions
version 0.07
Provides a README file which only contains the most important information for someone who may have extracted the distribution archive, but is unsure what it is and what to do with it.
In particular, the following content is included in the README:
main module name
distribution version number
first paragraph of the distribution POD's description section (or the abstract, if the description can't be found or is empty)
URL of the distribution's home page on MetaCPAN
installation instructions (for both tools and manual)
author identification
license statement
It may be assumed that people who are already familiar with Perl and its ecosystem won't usually read the README accompanying a CPAN distribution. They typically get all they need to know from MetaCPAN, and are accustomed to cpanm and other tools. Non-Perl people, however, might not know how to install a Perl distribution or how to access the documentation. In my opinion, this is the information a CPAN distro README really needs to provide.
cpanm
Identification of the module, on the other hand, may be kept very brief. A license file is included with the distribution, so stating the license is generally not required; however, this plugin will pick up any mangling done by Pod::Weaver::PluginBundle::Author::AJNN::License.
Whether the distribution is available on CPAN. The default is yes. If set to no, the link in the readme will be changed to GitHub and CPAN will no longer be mentioned in the installation instructions.
cpan_release = 0
Dist::Zilla::PluginBundle::Author::AJNN
Pod::Weaver::PluginBundle::Author::AJNN::License
Dist::Zilla::Plugin::Readme
Dist::Zilla::Plugin::Readme::Brief
Arne Johannessen (AJNN)
Arne Johannessen has dedicated the work to the Commons by waiving all of his or her rights to the work worldwide under copyright law and all related or neighboring legal rights he or she had in the work, to the extent allowable by law.
Works under CC0 do not require attribution. When citing the work, you should not imply endorsement by the author.
To install Dist::Zilla::PluginBundle::Author::AJNN, copy and paste the appropriate command in to your terminal.
cpanm Dist::Zilla::PluginBundle::Author::AJNN
CPAN shell
perl -MCPAN -e shell install Dist::Zilla::PluginBundle::Author::AJNN
For more information on module installation, please visit the detailed CPAN module installation guide.