Beefy Boxes and Bandwidth Generously Provided by pair Networks
The stupid question is the question not asked
 
PerlMonks  

comment on

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

I also don't mind if people post nodes to Meditations that are meditative which then result in replies being taken into consideration and an updated version being posted as a Tutorial. While many Meditations are informative and well written, most of them are not tutorials and don't fit in a section called "Tutorials" (where people expect to find material that tutors them, not just every node ever written that is informative). So I think the authors should be moving nodes to Tutorials by republishing them not by having the first draft and a bunch of replies just dumped into the Tutorials section.

I'm not a great fan of trashing the careful organization of tutorials to replace it with just listing all tutorial grouped into sections. I think we should keep both, the organized list of tutorials maintained by janitors (and SiteDocClan though I don't think they have access to do so yet) and also plain lists of all tutorials by section and sorted by reputation.

The we have the historic problem of a bunch of nodes that are in the Meditations section but are linked to from the Tutorials page. This makes finding such information via Super Search confusing. That is another reason why I like having a first draft in Meditations and, if it is well enough received, have an improved version in Tutorials and, of course, each should end up containing a link to the other. Then people can search for something they remember seeing in Meditations or they can search for Tutorial information.

- tye        


In reply to Re^2: Rethinking Tutorials (both) by tye
in thread Rethinking Tutorials by gmax

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 romping around the Monastery: (6)
As of 2024-03-29 01:17 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found