tags:

views:

449

answers:

5

The documentation with the module itself is pretty thin, and just tends to point to MOP.

+4  A: 

Have you look at http://search.cpan.org/~drolsky/Moose-0.57/lib/Moose/Intro.pod?

David Medinets
Yeah, I've seen that. And it's not bad.
Axeman
+20  A: 

First you should read through the Manual if you haven't already. Then you can go on to read the Cookbook.

I think the docs are actually pretty good these days, as long as you read the right ones. You really shouldn't bother looking at most of the docs for any class name starting with "Moose::Meta" unless you're interested in Moose's introspection features. I've tried to make this more obvious in the Moose.pm docs, which as of 0.57 tell you to read the Manual and Cookbook first.

If you're coming from a background of doing Perl 5 OO "the old school way", I'd also suggest taking a look at the Moose::Manual::Unsweetened document, which compares Moose to equivalent Perl 5 "by hand" code.

Dave Rolsky
The documentation does seem to be better for 0.57, Dave. I'm going to look at Unsweetened tonight. Thanks.
Axeman
+7  A: 

Once you read the docs Dave mentioned, if you have some insight on how it could have been more approachable or gotten you off on the right foot (or simply been easier to find), perhaps you would like to contribute that to the documentation. The developers cannot really read the introductory documentation from a new user's point of view. So file a bug report (with a patch maybe) against the documentation and/or discuss it on the mailing list or irc channel. That will help the next person in your shoes.

Eric Wilhelm
I'll take some notes about my learning process, write something up, and submit them to Dave, if he finds them valuable, he can include them. Thanks.
Axeman
+6  A: 

http://moose.perl.org is a good central resource for all things Moose

draegtun
+1  A: 

I found this Moose Quick Reference sheet invaluable. I'm always forgetting in which manual section to look up a particular feature.

Ether