Grant Complete: Pod Munging Utilities
Mon, 26-Oct-2009 by
Ricardo Signes
edit post
It is with great pleasure that I am able to announce, on behalf of Ricardo Signes, that the TPF-funded work on Pod::Elemental and Pod::Weaver is complete! Here's his final report:
Just a few days after predicting that the months-old grant was half done, it became quite clear that the first half was much, much more difficult than the second.
The [initial grant proposal](http://www.perlfoundation.org/pod_mangling_utility_improvements_ricardo_signes) listed the following targets:
* clearly defined and test Document and Nester classes
* Dist::Zilla plugins to allow easy use of Pod::Weaver with Dist::Zilla
* "allow" and "accordion" Pod weavers
* a configuration loading system
* dialects to allow things like embedded [WikiDoc](http://search.cpan.org/dist/Pod-WikiDoc/) sections
As of today, all of these goals have been met. The design of the system changed significantly from the time of the initial grant proposal, but it can do everything that was promised and more, and has proven very easy (in my experience) to build with and customize. There are many obvious improvements that can be made, and these will happen naturally now that the system is written and usable.
I have posted [a simple overview of Pod::Weaver's behavior](http://gist.github.com/217004) to give a basic idea of what the system can do out of the box.
I'd like to thank the Perl Foundation for their sponsorship of my work, which would have remained very easy to put off without the added incentives of pride and remuneration. I'd also like to thank my grant manager, Ricardo, who was at my side through the whole project.
You can find the products delivered or substantially improved as part of this grant below:
* [Pod::Weaver](http://search.cpan.org/dist/Pod-Weaver/)
* [Pod::Elemental](http://search.cpan.org/dist/Pod-Elemental/)
* [Pod::Elemental::Transformer::WikiDoc](http://github.com/rjbs/pod-elemental-transformer-wikidoc/)
* [Pod::Eventual](http://search.cpan.org/dist/Pod-Eventual/)
* [Dist::Zilla::Plugin::PodWeaver](http://search.cpan.org/dist/Dist-Zilla-Plugin-PodWeaver/)
* [Dist::Zilla::Plugin::PodPurler](http://search.cpan.org/dist/Dist-Zilla-Plugin-PodPurler/)
* [Config::MVP](http://search.cpan.org/dist/Config-MVP/)
Comments (0)