You do understand your anonymous comment has a less than zero chance of being considered constructively?
Now if you make anonymous criticism but you justify said criticism, I might have a shred of respect for your opinion.
| [reply] |
If you wanna play dumb... last check, CORE was set. Confuses pod with 'perldoc', pod with perl documentation, and then suggests wiki as better format, and continually craps on pod and how he hates pod because pod is crap.
| [reply] |
CORE is set for what 5.12? Says who? You're telling me without 5.10 out, some mythical entity has said nothing new can be added to CORE?... I've never heard of such a thing.
It's my opinion that POD is a bad format, and perldoc is an old method of getting things done that needs to be reexamined. The majority of my technical complaints can be overcome with Moose, and the majority of documentation complaints could be overcome with greater community support. With that said, in my eyes, making it easier for the community to become involved should be a priority. The success of a wiki's over the traditional doc-patch approach has proven itself for most every project, look at the amount of Frameworks and modules that have auxiliary wikis. The wiki's actually hurt CPAN as is because CPAN is no longer your central source for all things perl, so I'm saying CPAN needs wiki-support for docs, perldoc needs to be a front-end into it, and pod needs a revamp and tuning to take it back to source-comments and away from tutorials.
Evan Carroll www.EvanCarroll.com
| [reply] |