Beefy Boxes and Bandwidth Generously Provided by pair Networks
Do you know where your variables are?
 
PerlMonks  

Re: Rethinking Tutorials

by eyepopslikeamosquito (Archbishop)
on Jan 10, 2005 at 03:56 UTC ( [id://420806]=note: print w/replies, xml ) Need Help??


in reply to Rethinking Tutorials

Was it really the author's decision? Perhaps it was in that particular case, but I believe that in a more general way this may not be the truth.
Last week, I noticed that Writing Solid CPAN Modules was considered to be moved to Tutorials. Despite having been a monk for two years, I was, cough, hardly aware of the Tutorials section and it never occurred to me to post it there! So, I was pleased to learn about this possibility and will consider posting there next time.

On reflection, I agree with tye that many meditations (including mine) are not complete or detailed enough to be a tutorial, but could be polished up to a high enough standard with some extra effort from the author and especially by incorporating the feedback got from the meditation.

Replies are listed 'Best First'.
Re^2: Rethinking Tutorials
by davido (Cardinal) on Jan 11, 2005 at 20:47 UTC

    In defense of the "The author chose to post to Meditations, let's respect that" attitude, broaden that beyond the simple Tutorials discussion:

    • If an author chooses not to use active links when providing a URL, should Janitors linkify the URL?
    • If an author chooses not to activate links to POD when mentioned, should Janitors add this functionality to the node in the author's behalf?
    • If an author chooses not to pod-linkify instances of Perl function names (eg. chooses not to turn 'print' into [doc://print]), should we be changing that too?
    • If an author makes a spelling error in the body of a node, should we fix that for them?
    • If an author is a non-english speaker should we repair his grammar to make the node more understandable?
    • If we think an author's question or meditation could be worded better, should we change it?
    • If an author who has been here at the monastery for several years, and who has participated to the extent that (s)he has become a saint, and that author posts a Meditation, and if that post is clearly ON-TOPIC as a meditation, should we presume to know the author's intent better than (s)he does, and vote to move his/her post into Tutorials?

    It is my belief that in most cases, the answer to these questions is no. We shouldn't take it upon ourselves to change nodes unless something is actually broken.

    Janitors fix things like formatting, unsearchable titles, profanity, broken tags, broken links, move posts out of sections where they're off-topic, into sections where they're on-topic (eg., from PMDiscussion to SoPW), and this sort of cleanup maintenance. But Janitors don't write nodes for people, fix their spelling and grammar, improve clarity in language, or haphazardly move nodes from one on-topic section to another on-topic section. Janitors don't presume to know better than the author, with respect to content or placement, unless placement of a node is clearly in error. If a well-established monk chooses to post a Meditation, what right do we all have to force it to be a Tutorial instead? And if it was posted as a meditation accidentally, that author can easily /msg the Janitors requesting a move into Tutorials.

    Many things can and should simply be accomplished by sending a /msg to an author. In the case of "promote to tutorials", it would be much better for an author to take the content of his/her meditation, and work it themselves, in their own words and style, into a real tutorial, and then post this newly reworked article as a tutoral. If someone's meditation is something that is close to being a great tutorial, /msg the author asking him or her to work it up into one and post it. Many people will respond favorably to such requests.


    Dave

      Reply saved as draft.

Log In?
Username:
Password:

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

How do I use this?Last hourOther CB clients
Other Users?
Others examining the Monastery: (4)
As of 2024-04-20 04:05 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found