Beefy Boxes and Bandwidth Generously Provided by pair Networks
"be consistent"

Comment on

( #3333=superdoc: print w/replies, xml ) Need Help??

I am POE's lead developer, lead documenter, and lead site designer. I'm also the lead support agent, head fluffer, and chief bottle washer. I do all these things and more, even Europa, because nobody else does. If you would like to share or wear one of these hats, send me a note.

Thank you all for the feedback. POE is free software, and I spend most of my free time working on it. As such, I don't have much time to read PerlMonks. I wouldn't have even looked at this node if someone hadn't pointed it out to me.

If you're serious about making a difference in the project, please consider posting your feedback somewhere more useful. That would be my inbox, or POE's mailing list, or even a small note on the wiki itself.

If you're just looking for a place to vent ineffectually, I suggest SlashDot instead of PerlMonks. They really get off on plagiarized Roger Ebert reviews.

While I'm here:

POE's documentation is big. Really big. Like 120 printed pages for the perldoc alone. The web Cookbook is probably another 70 pages, and then there are the tutorials1,2,3,4, the FAQ, and other discussions. It's probably enough to make a book.

Unfortunately it's not book-quality documentation. I'm rewriting it in my spare time, which is obviously not fast enough. If you'd like to help it be done sooner, let's talk.

Hossman's right. The site is a wiki. It's easy to update. A lot of people do change it. Thank you, people! It's great stuff, especially since any time I'd have to manage the site would probably be better spent revising documentation.

William G. Davis is only partly correct about global.css. It's not editable directly, but you can change the site's style sheet. The user preferences include a field where you can insert your own styles or link to an entire stylesheet. It's mentioned towards the bottom of the main page.

DrHyde's impression of POE seems to be stale. A few years ago the test programs were all the samples it had. These days I wouldn't wish them on anybody.

The Cookbook is the main repository for sample programs now. So far there are 45 complete, commented programs covering different tasks. Many of them were written on request, so request something if you'd like to see it there. Likewise, let me know if any are out of date---it happens. Better yet, do like others have done, and patch the code without bothering me. It is a wiki.

Thanks again for the feedback, and thanks for reading.

-- Rocco Caputo - -

In reply to Re: Documentation for POE? by rcaputo
in thread Documentation for POE? by sri

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

  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.
  • Log In?

    What's my password?
    Create A New User
    and all is quiet...

    How do I use this? | Other CB clients
    Other Users?
    Others musing on the Monastery: (3)
    As of 2017-11-21 04:37 GMT
    Find Nodes?
      Voting Booth?
      In order to be able to say "I know Perl", you must have:

      Results (295 votes). Check out past polls.