Beefy Boxes and Bandwidth Generously Provided by pair Networks
Pathologically Eclectic Rubbish Lister

comment on

( #3333=superdoc: print w/replies, xml ) Need Help??
Some thoughts:
  1. People have acquired the instinct to delete anything long that comes into their mailbox as a result of filling out a "sign me up" web form. So, I'd like to argue that this doc should be as lean, and as to the point, as possible. Don't try to explain or point out everything; that's an unreasonable goal for this sort of auto-sent welcome message. If a better introduction is needed, then maybe the PM FAQ or other doc pages should be revised.

    Or else, as perigeeV suggests, maybe it should be the page that pops up after creating a new user; label it "New Monk Info Page" and stick in the right column under "Information". Or even situate the link somewhere at the top of the home node of all users during their first 2 levels.

  2. Item #12 should top the whole list. Also, note that the first link under #12 makes all of item #3 redundant. Item #3 is fairly confusing in this context anyway.

  3. After #12 should come #9, followed by a combined list of links to FAQs and manpages under a generic and brief, "If you're looking for help, have you tried any of these sites yet?"

  4. After all the hubbub, you just can't leave out!

  5. The formatting on the links is a little mixed up in places. (I assume that you won't be sending HTML-format mail?) Here's what I'd recommend:
      name of URL, indented slightly (no tabs):
        full URL, indented slightly more, 
        maybe surrounded by one species of bracket or another 
        (if that won't break an HTML-based reader)
    This especially includes the Perlmonks node links that you've included.

  6. Is "have you read the man pages" really necessary? I'd have thought that Perlmonks was relatively obscure enough that to have found it, you'd already know about the existence of man pages. However, one thing that I have found to be obscure to some novices is the perldoc command; you should touch very briefly on this along with the FAQ/man stuff. (Even just a hint to try typing 'perldoc perldoc' would be great.)

  7. "Generating its own *superior* FAQ"...I don't want to knock Hubris, but I think this will come off as too smarmy for a greeting message.

  8. "At the risk of being branded a heretic" - I don't know if that's just your own parenthetical comment, but this should probably be dropped from the final message.

  9. I second the emotion: drop #13. Either completely, or replace it with a Saints link. Let them explore the Monastery in their own sweet time; if it matters to them, they'll come to know the Saints and their home nodes soon enough, and if it doesn't, it's just more noise in the message, drowning out signal.

I hope this doesn't come off as too harsh. This is a good idea, but I just think it should be lean & mean; otherwise, most people won't give it the full attention it deserves. In fact, the more I think about it, the more it makes sense to have this as a web page rather than (or in addition to) an email; that way, people can bookmark it (rather than losing it to the depths of their inbox, or automatically hitting the 'd' key), and people can merrily click away to browse all of those Perl/Perlmonks documentation sites before they jump into posting.

-- Frag.

In reply to Re: New Monks by frag
in thread New Monks by tachyon

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 the web crawler heard nothing...

    How do I use this? | Other CB clients
    Other Users?
    Others scrutinizing the Monastery: (2)
    As of 2020-06-06 19:39 GMT
    Find Nodes?
      Voting Booth?
      Do you really want to know if there is extraterrestrial life?

      Results (41 votes). Check out past polls.