I've just read agianni's post about wanting to post a series of articles to Meditations with refactoring examples in Perl converted from original ones in Java. Which makes me wonder -and I already did in the past, but "this kinda thing" is uncommon enough not to bother too much about it- whether there's any recommendation or guideline about "how" how to do so. I basically see two approaches:

Opinions? Ideas?

Replies are listed 'Best First'.
Re: Posting a series of articles...
by jdporter (Paladin) on Jun 20, 2007 at 21:46 UTC

    In general, I'd think the latter is better, more flexible yet stable; but I would add that each article in the series should also have links near the top to the prev/next articles and the head/toc article, for clicky nav.

    A word spoken in Mind will reach its own level, in the objective world, by its own weight
      In general, I'd think the latter is better, more flexible yet stable;

      One obvious advantage is that root nodes seem to have a better visibility than notes. Thank you for the added remarks too, I will certainly want to take them into account should I ever start a thing like this myself. (And I have a half-hearted idea of doing so - otherwise I wouldn't have been meditating about the issue. Incidentally it's somewhat related to another topic discussed today.)

Re: Posting a series of articles...
by Limbic~Region (Chancellor) on Jun 20, 2007 at 22:26 UTC
    blazar,
    A few examples I can think of are - perl idioms explained, the lighter side of perl culture, obfu balls, and the annual Sports Illustrated image grabber. I am sure there are others but it seems that both of your suggestions have been used.

    Cheers - L~R

    Sorry for not providing links. I may update as time permits.
Re: Posting a series of articles...
by agianni (Hermit) on Jun 21, 2007 at 12:11 UTC
    My intent was to do the latter: multiple root nodes with similar titles. I think that will make it easier to track down the primary content. I'm happy to be a guinea pig with this and I'm happy to accept tactical comments to the postings if anyone finds that this method isn't working for some reason.
    perl -e 'split//,q{john hurl, pest caretaker}and(map{print @_[$_]}(joi +n(q{},map{sprintf(qq{%010u},$_)}(2**2*307*4993,5*101*641*5261,7*59*79 +*36997,13*17*71*45131,3**2*67*89*167*181))=~/\d{2}/g));'
Re: Posting a series of articles...
by jdporter (Paladin) on Jun 22, 2007 at 18:44 UTC

      Yeah, I noticed that about the first Refactoring Perl node I posted. I'm planning on going back and changing that to "Refactoring Perl - A Proposal" or something like that. I also found that I can use supersearch to narrow down the search such that it would only ever retrieve my root node postings. I'm planning on putting a link to that search result on my home node at some point -- like once I have a few more written.

      perl -e 'split//,q{john hurl, pest caretaker}and(map{print @_[$_]}(joi +n(q{},map{sprintf(qq{%010u},$_)}(2**2*307*4993,5*101*641*5261,7*59*79 +*36997,13*17*71*45131,3**2*67*89*167*181))=~/\d{2}/g));'
Re: Posting a series of articles...
by shmem (Chancellor) on Jun 20, 2007 at 22:27 UTC
    Another way would be posting something as DRAFT and updating that root node. To prevent that root node to fall into oblivion update notes could be posted as replies. There are examples in jdporter's dacha.

    --shmem

    _($_=" "x(1<<5)."?\n".q·/)Oo.  G°\        /
                                  /\_¯/(q    /
    ----------------------------  \__(m.====·.(_("always off the crowd"))."·
    ");sub _{s./.($e="'Itrs `mnsgdq Gdbj O`qkdq")=~y/"-y/#-z/;$e.e && print}

      Interesting that you bring that up. Indeed, I too was thinking of it as an example of posting a series of articles as replies to an umbrella node. However, your characterization that those replies update their parent is not quite accurate. It could be done, of course; but my dacha (which I've restyled my "treehouse") is not an example of that.

      OTOH, an example I've done of using a reply to update a root node, rather than modify the root, is Tk Photo Slideshow - Production Release.

      A word spoken in Mind will reach its own level, in the objective world, by its own weight
      Another way would be posting something as DRAFT and updating that root node. To prevent that root node to fall into oblivion update notes could be posted as replies.

      IIUC, this is a sort of variation on the first scheme I mentioned: it is interesting and efficient. But I fear it may cause some problems with replies from other people, if people are supposed to discuss the topic. Now that I think of it, for maximum efficiency -and depending on the actual kind of content- one could take a third approach consisting basically of both:

      • the user, e.g. me posts an umbrella node with an indicative title, e.g. "blazar wants to do it" and explains there the stated goal of the planned series of articles, asking people to please do not post followups directly under that thread;
      • he posts the first article as a separate root node in the appropriate section, with a title like "blazar wants to do it - part I: conquer the world (DRAFT)". He puts a link to the umbrella node and a link in the umbrella node, to the draft;
      • after hundreds of monks contribute their words of wisdom about how to conquer the world, the user will want to update the original draft with all of their suggestions. Thus he will post a direct reply under the umbrella node with the finalized version, putting there a link to the draft version and vice versa;
      • and so on for the other articles...

      Sounds complex, but it sounds more than it actually is. It allows for separation between user discussions and nicely presented material. It is weak in that it depends on good will on part of "others" and however carefully you try to state something in an idiot proof manner, along comes a better idiot. But all in all I'm confident that as a scheme it would be robust enough. And yes: it allows for some DRY violation but not in an upsetting manner, IMHO.

Re: Posting a series of articles...
by Anomynous Monk (Scribe) on Jun 21, 2007 at 02:21 UTC