Beefy Boxes and Bandwidth Generously Provided by pair Networks
"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??


in reply to Re^3: I want site documentation updates and I want them now.
in thread I want site documentation updates and I want them now.

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.

Juerd # { site => 'juerd.nl', do_not_use => 'spamtrap', perl6_server => 'feather' }

Log In?
Username:
Password:

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

How do I use this?Last hourOther CB clients
Other Users?
Others about the Monastery: (6)
As of 2024-03-29 22:49 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found