The CPAN Book
About a month or two months ago I started writing together with Smash, a book on CPAN modules and frameworks. The final name and table of contents is not yet fully defined, but some chapters are already popping out.
I put up a simple page where the draft documents will appear. I know the URL sucks, but I might fix it soon. At the moment I made one chapter available.
The final document will be made available in electronic format freely to the community (without that DRAFT watermark, that is there just so you know this wasn't yet revised). Also, a printed version will be available, probably in lulu, but not yet totally defined.
The book is being written in PseudoPod, and it available on GitHub. Refer to the book page for details.
I am happy with comments, corrections and grammar fixes. We know our English sucks. Just try to be positive, or we might end up quitting from this job :)
UPDATE: check the new webpage address: http://ambs.github.com/Books.
I blog about Perl. D'uh!
This looks like a great project. I would say that some kind of guide to CPAN is actually badly needed. Thanks for doing this!
Great idea! I think I need to poke around in the source a bit later...
Please do not (yet) include Moo in your book.
Mouse and Moose are both very stable modules which compliment each other fairly well, but ultimately do not always easily play well together. It is, and always has been, a stop-gap solution (a really good one too, gfx++).
Moo is an attempt by Matt Trout to solve this problem such that a Moo class can easily be automagically upgradable to a Moose class when needed during runtime. The idea is that it will alleviate the need for Mouse entirely by making Moose lazily loaded if and only if you need it. That said, Moo is still in the quite experimental stage (mst probably disagrees with that statement, but really, the mst definition of "experimental" is a scary thing to behold) and (at least for now) so should not be actively recommended to people (yet).
Alberto, do you have rss link to that website/project?
Sorry to answer to two comments on a single post:
- Leo, probably GitHub has it, for the commits. For the website, I do not have it yet, but I'll post here whenever a new chapter is made available.
- Stevan Little, knowing MST I agree that the code might be too experimental to be included. In any case, you might notice that the features I describe for Moo are the basic basic :) And until the book gets officially out, it is always possible to refactor the chapter and remove Moo :) So, do not read this as "I will not remove it" neither as "I will remove it". At the moment I really prefer to be lazy and give some time before taking a decision :)
I think it's great to have another one, but there's one already in Japanese :)
http://www.amazon.co.jp/Perl-CPAN%E3%83%A2%E3%82%B8%E3%83%A5%E3%83%BC%E3%83%AB%E3%82%AC%E3%82%A4%E3%83%89-%E5%86%A8%E7%94%B0%E5%B0%9A%E6%A8%B9/dp/486267108X/ref=sr_1_1?ie=UTF8&qid=1310079854&sr=8-1
apparently it's been selling pretty well too!
Hi Alberto,
I own the domain cpanoramic.org which is admittedly a little hokey. It doesn't look like I'm going to do anything with the name and would be up for donating it to this project.
Let me know. Keep up the great work.
Luis :)
What would be nice to have is:
* Web frameworks (including Plack / PSGI)
* Event loop / Async
Is it also going to include things like CPAN::Mini?
By the way...great idea.
Unfortunately we can't include everything. We are trying not to include small modules, like List::Util, that are great. Aiming a print version we need to keep the number of page bellow 400/500 pages... but lets go and see.
I would think creating a local CPAN mirror would warrant a section in there somewhere. But that is just my opinion. :)