Beefy Boxes and Bandwidth Generously Provided by pair Networks
Don't ask to ask, just ask
 
PerlMonks  

Re: Obtruding Writeup Formatting Tips

by ambrus (Abbot)
on Mar 04, 2008 at 16:55 UTC ( [id://671929]=note: print w/replies, xml ) Need Help??


in reply to Obtruding Writeup Formatting Tips

I oppose this. It would be rude for the newcomers, and possibly confusing as well.

Also, those suggestions under the writeup box should be brought into a better form than what they are now. I don't really know what they should tell, and whatever it is, there will be people not reading it, but we should think of those who do read it.

Replies are listed 'Best First'.
Re^2: Obtruding Writeup Formatting Tips
by Fletch (Bishop) on Mar 04, 2008 at 22:02 UTC
    I've always said you can get more with a kind word and a two-by-four than you can with just a kind word. – Marcus

    Barging in and dropping an ill-considered pile of poorly formatted question without taking the time to learn the lay of the land would be rude of newcomers, yes. :) If the presence of such a (pointed, or blunt) warning dissuades them before they commit such a gaffe then both the poster and the readers are served.

    Not to mention that the warning properly styled (<span class="lazy_boor">...</span>) would make a handy hook . . . .

    The cake is a lie.
    The cake is a lie.
    The cake is a lie.

Re^2: Obtruding Writeup Formatting Tips
by menolly (Hermit) on Mar 04, 2008 at 18:41 UTC
    I've occasionally wished the tips included a quick reference to shortcuts, or at least a direct link to that node.
Re^2: Obtruding Writeup Formatting Tips
by shmem (Chancellor) on Mar 04, 2008 at 21:38 UTC
    It would be rude for the newcomers

    You did see the "such as", dinn' ye? It hasn't to be just literally that line.

    But see, running h2xs -AX -n Quux yields the following DESCRIPTION pod

    Stub documentation for Quux, created by h2xs. It looks like the author of the extension was negligent enough to leave the stub unedited. Blah blah blah.

    so I guess a similar default text could pass as "good practice"...

    --shmem

    _($_=" "x(1<<5)."?\n".q·/)Oo.  G°\        /
                                  /\_¯/(q    /
    ----------------------------  \__(m.====·.(_("always off the crowd"))."·
    ");sub _{s./.($e="'Itrs `mnsgdq Gdbj O`qkdq")=~y/"-y/#-z/;$e.e && print}

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://671929]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others drinking their drinks and smoking their pipes about the Monastery: (6)
As of 2024-04-23 07:57 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found