Moose Docs Grant Moving Forward – Recipe Revision

The latest release of Moose, 0.69, marks another completed deliverable in the Moose docs grant. For this release, I finished revising every cookbook recipe in the distro.

My goals were to generally improve the text (Stevan is wordy in hist first drafts ;), and also to make sure we are consistent in our terminology and style.

I also ended moving a fair bit of documentation from cookbook recipes over to the manual. Before the manual existed, some “general doc” pieces ended up in the cookbook for lack of a better home.

In particular, I ended up adding a fair bit of content to the Best Practices manual based on some writing that used to live in Moose::Cookbook::Style.

Comments

matt, on 2009-02-13 11:09, said:
just popping in to say thanks for your work, its appreciated

John, on 2009-02-13 11:14, said:
The new documentation is excellent. Fantastic job.

james, on 2009-02-13 16:26, said:
More details on using Moose with Error objects (not Error, that seems to be incompatible with Moose) would be good.

yanick.myopenid.com, on 2009-02-14 15:54, said:
Thanks for the lovely documentation. It’s very much appreciated. :-)

I’ve passed the new Moose::Manual::* through my Pod::Manual machine and generated a pdf version of it (well, two actually: one using LaTeX, one using Prince). The pdfs are at http://babyl.dyndns.org/techblog/manuals/ if you are interested.

sawyer, on 2009-02-15 03:15, said:
I always loved the Moose documentation but now it’s even better! Great job! I especially liked Moose::Unsweetened!