"be consistent" | |
PerlMonks |
Re^4: I want site documentation updates and I want them now.by Juerd (Abbot) |
on Dec 11, 2006 at 22:45 UTC ( [id://589180]=note: print w/replies, xml ) | Need Help?? |
Why should perldoc links enjoy special status? I much more often link to module documentation so that is what should have special status isn't it? Module namespace is in flux, while the perldoc list remains mostly static. This makes schemaless use very hard. I agree that it would be very nice to have easier links. Perhaps [[foo]] would be a solution, where this always links to documentation. perldoc.perl.org if the document is known to exist there, search.cpan.org/perldoc?foo otherwise. http://tnx.nl/foo already implements something like that. DWIM is fine where there is a clear "best guess" at the intended behaviour, but quickly becomes nasty when too much second guessing is involved. "perlop" and friends can be guessed with certainty, so that's not a problem. In this case I think typing 6 extra characters for most links is a very minor burden It's not that 6 characters by itself is a lot of work. It's that it changes the way one edits the line, which is especially relevant in the chatterbox, but no less important in normal writeups. The schema moves the link out of the realm of punctuation, into something that requires a conscious decision.
In Section
Perl Monks Discussion
|
|