Beefy Boxes and Bandwidth Generously Provided by pair Networks
Problems? Is your data what you think it is?
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??

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

In reply to Re^5: what would you like to see in perl5.12? by EvanCarroll
in thread what would you like to see in perl5.12? by ysth

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":



  • Are you posting in the right place? Check out Where do I post X? to know for sure.
  • Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
    <code> <a> <b> <big> <blockquote> <br /> <dd> <dl> <dt> <em> <font> <h1> <h2> <h3> <h4> <h5> <h6> <hr /> <i> <li> <nbsp> <ol> <p> <small> <strike> <strong> <sub> <sup> <table> <td> <th> <tr> <tt> <u> <ul>
  • Snippets of code should be wrapped in <code> tags not <pre> tags. In fact, <pre> tags should generally be avoided. If they must be used, extreme care should be taken to ensure that their contents do not have long lines (<70 chars), in order to prevent horizontal scrolling (and possible janitor intervention).
  • Want more info? How to link or How to display code and escape characters are good places to start.
Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others taking refuge in the Monastery: (4)
As of 2024-04-19 02:19 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found