hi all, triggered by a recent thread on london.pm, i decided there needs to be a few new perl documents aimed at newbies. two of them are easy to describe and one of those would be a great and easy group project.
the first document which i am writing (and would love edits/feedback/brickbats) i am calling perlmetadoc. it is all about the perl documentation, how to use and read it, etc. one issue with the docs is how large and confusing it all is. this doc aims to be a navigation through the docs with coverage of many things. i will post my current draft if you want. a goal for this is to be included in perl's core docs and also on the perl.org site. the other document i have named (but i am open to a better name) perlblurbs. it is basicly the 'perl' doc which lists all the docs with short topics with the topics expanded to a paragraph. a short topic doesn't tell you enough about what the doc covers, who is the audience, what are related docs, etc. this is the group project i mentioned. if a bunch of us took this on it would be done fairly quickly. i count about 170 documents (a large bunch are OS specific which won't need blurbs). this can be done incrementally so you can write up a blurb at a time without breaking into a sweat. a core group of us can edit them and add pod stuff (or you can help with podding too). i haven't started this yet but we can at the meeting. we can pick a doc and yell out the blurb and some lucky sole will type it up. a few of those to get us started will be great. then we can divvy up the rest to individuals. any interest in this (project and/or meeting idea)? thanx, uri -- Uri Guttman ------ [email protected] -------- http://www.sysarch.com -- ----- Perl Code Review , Architecture, Development, Training, Support ------ --------- Gourmet Hot Cocoa Mix ---- http://bestfriendscocoa.com --------- _______________________________________________ Boston-pm mailing list [email protected] http://mail.pm.org/mailman/listinfo/boston-pm
