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:
- Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
-
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
-
Outside of code tags, you may need to use entities for some characters:
|
For: |
|
Use: |
| & | | & |
| < | | < |
| > | | > |
| [ | | [ |
| ] | | ] |
- Link using PerlMonks shortcuts! What shortcuts can I use for linking?
-
See Writeup Formatting Tips and other pages linked from there for more info.
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:
- Use HTML entities for these characters (except when inside
<code> and <c> tags):
|
For: |
|
Use: |
|
For: |
|
Use: |
|
For: |
|
Use: |
| < | | < |
| [ | | [ |
| & | | & |
| > | | > |
| ] | | ] |
- Please format your posts using HTML, but only using
PerlMonks-Approved HTML tags:
a, abbr, b, big, blockquote, caption, center, col, colgroup, dd, del,
div, dl, dt, em, h3, h4, h5, h6, hr, i, ins, li, ol, p, readmore, small,
span, spoiler, strike, strong, sub, sup, table, tbody, td, tfoot, th,
thead, tr, tt, u, ul, wbr (allowed by discouraged: br, font, h1, h2, pre)
- Please read these before you post! —
- Links are easier with PerlMonks shortcuts, like
[http://perl.org/], [doc://open],
and [cpan://File::Find] ! What shortcuts can I use for linking to other information?
- See Writeup Formatting Tips and other pages
linked from there for more info.
- Read Where should I post X? if you are not
absolutely sure you are posting in the right place.
-
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.
|
|