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?
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;
|
|---|
| 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 |