Thanks for contributing this (of course). I'll just quickly address what I consider the most critical points:

Don't bury the lead. Keep it short. Don't require scanning.


If you want to get good answers:

Paste between <code> and </code> tags actual code that reproduces the problem and state exactly what the problem is and exactly what the correct behavior / desired output is. Additional background about what you are trying to do and why along with other things you have tried also helps.

For example:

<code> use strict; use warnings; ... </code> gives me the error <code> ... </code> I'm trying to ... <p> I also tried ...

If you don't have code (link)... If you don't get an error message (link)... If your code is too large (link)... If ...


I'll also try to find a good, short example to replace the "..."s with.

Rather than require scanning, include internal links so the reader can jump directly to the appropriate section.

If you have to apologize via "This is a little long" or "scattershot points", then you are writing to the wrong audience. Just fix such problems so no apologies are necessary.

Thanks again.

- tye        


In reply to Re: RFC - How to prod newbies by tye
in thread RFC - How to ask... by ww

Title:
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, details, 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, summary, 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.