Pod::Readme v1.0.2 released
I released a new version of Pod::Readme yesterday. It's a module for "Intelligently generate a README file from POD" by using POD =begin/=end and =for commands to control what parts of a module's POD are included/excluded in the README. For example, you don't need the details of method calls in the README, nor do you need installation instructions in the module's man page.
This is a major rewrite using "modern Perl" that supports the following features:
- Generating a README in various formats such as plaintext, POD, markdown, HTML;
- Support for plugins to add new features.
- Support for (via plugins) inserting the module version, recent changes and prerequisites in the README.
It should still work with existing software that uses it, such as Module::Build.
The next steps will be to write modules to integrate this with other release tools, such as Module::Install or Dist::Zilla.
Feedback as always would be appreciated. The module is on GitHub.
Thanks to everyone who commented on previous blog posts about this, and to CPAN Testers for test reports on previous dev releases.