You can lead a student to water but you can't make him Think! I don't think you are doing anyone a disservice by supplying code and explanations that either go beyond the documentation, or put the documentation into the context of the problem they are trying to address (which is what I think you usually do, and what I try to do when time permits). Some people, especially at first, find it hard to make the leap from the docs to their own problem space. If you supply both pointers and your additional helping hand approach, I don't think you are hurting anyone: Those who just need (or prefer) a pointer to the docs get one; those needing a little applied documentation transference also benefit --- and when/if they do read the docs, your additional demonstrations will probably help them further understand the docs. Those who blindly use your code without trying to understand are, well, ... blind by choice. Always remember, though, that this place is an archive --- just because you might suspect that the person asking isn't interested in reading the docs or learning doesn't mean that the next person with a similar question who happens across (or is pointed to) your post won't gain full benefit. Fuller explanations may seem wasted on some, but they are never really wasted.


In reply to Re: Pedagogy: pointers or plaintext posts by danger
in thread Pedagogy: pointers or plaintext posts by Ovid

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.