Beefy Boxes and Bandwidth Generously Provided by pair Networks
Perl-Sensitive Sunglasses

comment on

( #3333=superdoc: print w/replies, xml ) Need Help??

I suspect it's difficult to view this from the point of view of someone like me, but references to HTML are, to me, part of the problem rather than part of the solution. It took me years to understand the point of the paragraph tags. The text was improved dramatically some time ago, but even now, the phrase "PerlMonks-approved HTML" is one I find daunting.

I'm not here to learn HTML. I don't want to learn it as I have no use for it. I want to learn Perl, and that's hard enough. I've learned a little HTML because Pod2RTF doesn't produce a file that MessWord can read. The only other thing accountants (me and my audience) are likely to read is a web page, and since Pod2HTML is buggy, I've had to investigate the issues and find workarounds. Even that is a yak I'd rather not shave, so when I see "PerlMonks-approved HTML", it looks to me as though I must learn HTML and then the PM version of it in which I may have to unlearn some of the HTML I just learned. I really want to avoid shaving those yaks.

I would therefore suggest cutting down the current guidelines to something along the lines of "Posts are HTML formatted. If you want to know more about this, see Perl Monks Approved HTML tags. Otherwise, " followed by the current text on code & paragraph tags. But the huge body of text on HTML that follows it makes my eyes glaze over even now.

I accept that I'm hardly a typical user and that huge amounts of Perl are used in combination with HTML. But, to me at least, the heavy stress on HTML makes asking questions here less approachable.


John Davies

In reply to Re^2: RFC - shortform posting guidance for newcomers (meh) by davies
in thread RFC - shortform posting guidance for newcomers by ww

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, 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
  • 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.
  • Log In?

    What's my password?
    Create A New User
    and the web crawler heard nothing...

    How do I use this? | Other CB clients
    Other Users?
    Others avoiding work at the Monastery: (9)
    As of 2020-04-01 09:30 GMT
    Find Nodes?
      Voting Booth?
      To "Disagree to disagree" means to:

      Results (187 votes). Check out past polls.