The problem with all this is that even at the very core, the group of gods, this site is a distributed effort and very much a grown wilderness. Functionality has been added and some has also been abandoned over time, and content - even central content like FAQs and tutorials - is produced along the way by anyone who has the capability, time and mood to contribute.

And that's the problem right there, basically: the site is very community centered, more so than nearly anything else on the web. It's more of a wiki than a simple forum. That is the reason it is so confusing at first. Getting involved will not be an easy task for a newcomer, even given more documentation. I do agree that more documentation could and probably should be available, but offering it would be a bit like documenting which drawers in your room you put what stuff in - a lot of it is a matter of habit and some of ritual, so will necessarily seem obscure.

You simply have to take in the spirit of the site and its community for a while before it all makes sense the way it should - much like Perl itself can seem arcane at first, so does its community. Of course, that doesn't in any way constitute an excuse for insufficient documentation, but it does mean that just calling for "more documentation" is not going to change a whole lot.

Maybe any newcomers reading this would like to make a concerted effort of noting things down that confused them, or of things they found very valuable when they discovered them but which they had missed initially? That would help the more seasoned members provide answers on the one hand and pick out which parts are in particular need for documentation on the other.

As always, precise questions are more helpful to all parties involved than generic ones.

Makeshifts last the longest.

In reply to Re^2: Make Purpose of each Section clear by Aristotle
in thread Make Purpose of each Section clear by jdporter

Title:
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, details, 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, summary, 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.