Beefy Boxes and Bandwidth Generously Provided by pair Networks
There's more than one way to do things
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??
I think it's great that you're working on this. Like tye said, brevity is crucial. Simple, direct language with examples will also go a long way. Many monks and visitors have English as a second (or third... or fourth, you show-offs!) language. Below is a stab at the way I'd approach it. It's a first draft so feel free to munge or poach if you like it.

How to ask a question on Perl Monks

First time? Ask your question here: Seekers of Perl Wisdom (SOPW). Scroll to the bottom and enter it under Add your question. There are other sections of the site but SOPW is most likely what you want.

How to help the monks help you

Title your question well. The title should contain the gist or subject of your question or problem.

Examples of good titles–

  • CGI::App session params losing values between redirects
  • Better union of sets algorithm?
  • Do file test operators cache stat calls?

Titles that are not helpful–

  • HELPPP !!!! ME
  • Good morning, monks

Your question is being read by others who cannot see your screen, your code, or what you are trying to do. If you want a good answer, you need to give all the information someone else would need to understand the problem.

Example of a good question–

Why do selects fail sometimes with DBI

…I can’t figure out why my selects fail sometimes but work other times. This is my code:

my $dbh = DBI->connect($data_source, $username, $auth, \%attr); my $sth = $dbh->prepare("SELECT foo FROM bar WHERE baz = '$qux'"); $sth->execute();

Example of a poor question–

I'M ON A DEADLINE! PLEEZE HELP!

Why doesn't my CGI work?

There is no way to answer that question. 1,000 things could be wrong with a script and "work" is not even meaningful without first knowing what it's supposed to do.

Use PerlMonks formatting + simple HTML. Put <code>code inside code tags</code>. They are treated specially here. Please do not use <pre>pre tags</pre>!

(et cetera?)


In reply to Alternative "how to ask" stub by Your Mother
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":



  • 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 meditating upon the Monastery: (5)
As of 2024-03-29 07:51 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found