in reply to Re: Why not a "living" PerlDoc? Others have it, why not Perl? (boring thoughtis)
in thread Why not a "living" PerlDoc? Others have it, why not Perl?

Greetings.

Thanks for putting so much into your reply. I had actually envisioned much, if not most of what you spoke of.
Specifically:

Regarding Augmentation via Forum; I've seen this done before by way of a Teaser (comment on this...). That was a link to a section in a Forum. Liked it, and hated it simultaneously. Hated it, as you had no prior knowledge whether the comment you wanted to make wasn't already made by someone before you. You also end up loosing your place in the Document for no reason. Because you find someone already said that. I think a Forum would be helpful. But would never do it that way.

As AnnoCPAN goes; I intend to insert the comments into the document(s). As opposed to placing them into the margin(s). I think that given the comments are intended to augment the current, and that (by some means) the comments have been QC'd. It makes the document overall, better.

I also see no reason that (should I choose to leave it in pod format) it couldn't be shipped with Perl itself. Or as a diff for installations that already exist. In fact, authors of the comments could be <cite>ed throughout the document, and listed at the bottom. Which is, of course what CITE means. ;P

I will elaborate further. But as I haven't yet finished my first cup of coffee, I've already taken too big a chance writing this much. :)

Thanks again, for having shared such an elaborate opinion on this. I really appreciated it.

--Chris

P.S. Did I really overlook your reference to AnnoCPAN? (apologies, if I did)

#!/usr/bin/perl -Tw
use Perl::Always or die;
my $perl_version = (5.12.5);
print $perl_version;
  • Comment on Re^2: Why not a "living" PerlDoc? Others have it, why not Perl? (boring thoughtis)

Replies are listed 'Best First'.
Re^3: Why not a "living" PerlDoc? Others have it, why not Perl? (boring thoughtis)
by soonix (Chancellor) on Nov 21, 2013 at 11:12 UTC

    Or as a diff for installations that already exist
    If I understand it right, perldoc already is in a git repository (together with perl itself). If you could automatically turn this into pushes, that would be the best way (I think).

    For several postings here, both of my own and from others, I wish for a version controlled PerlMonks. Your annotation system would be another candidate for such an approach.