Beefy Boxes and Bandwidth Generously Provided by pair Networks
Clear questions and runnable code
get the best and fastest answer
 
PerlMonks  

comment on

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

Here is a format for such a suggestion that I find much easier to evaluate:

Consider changing the "add your question" display area to include:

(show your suggested content)

In context, please consider changing from the current:




Title: [ (box to enter title) ]
Your question:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":
[
  (big box to enter node "HTML")
]

[ ("preview" button) ]



To:



(put your replacement here)


To be clear, I'm not at all sure what parts of the above you were hoping to replace.

I'm pretty happy with this bit:


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

The rest, most people don't even notice. But I also like the simple list of HTML escapes.

Providing text for people to read has proven almost pointless for a large number of posters. The "two-lines showing example mark-up" just sinks in almost without even engaging your "read English" synapses. The stuff below the input box is going to be widely ignored. Putting any links before the input box is too disruptive to standard keyboard navigation, IMHO. Putting more than a very few lines of text before the input box is too disruptive to visual understanding, IMHO. Putting example mark-up inside the text box is dang hard to get right (for example, it will very often end up being left in).

I think we'd probably have a more positive impact by just replacing the last of those three "pre" lines with a very terse but clear notice that "look just under this text-input area for much more help". Especially if that help immediately starts with visually obvious bits (like the list of HTML escapes).

I find your wording mostly "tl;dr" and when I force myself to read it, it flows badly as a bullet list. Where you put bold means that if I try to skim I get really little of value: "tiny code how sample data verbatim identifies your topic".

Several of the things you ask for I don't think are relevant often enough to even mention so prominently. The important bits, IMHO, are just:

Basic formatting:

<p> paragraphs go here </p> <c> code goes here also sample input also error messages or broken output also desired output </c>

But I also don't see how to convey even that with enough: terseness, clarity, snappiness. Perhaps more like:

How
to
write:
<c>
  code goes here, as does:
  sample input, desired output,
  errors, and broken output
</c>
<p>
  paragraphs go here
</p>
Important help information is just below this input box.

I actually find the below-box text much easier to improve:



- tye        


In reply to Re: RFC - shortform posting guidance for newcomers (meh) by tye
in thread RFC - shortform posting guidance for newcomers 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: (6)
As of 2024-04-19 10:23 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found