Beefy Boxes and Bandwidth Generously Provided by pair Networks
good chemistry is complicated,
and a little bit messy -LW
 
PerlMonks  

On good hyperlinking (was Re: Config Files Redux)

by merlyn (Sage)
on Nov 23, 2006 at 18:44 UTC ( #585763=note: print w/replies, xml ) Need Help??


in reply to Config Files Redux

In this node I said that for large config files (a condition of the OP) that I preferred XML to many other mechanisms including oodles of name=value pairs.
No, it's not in "this node". It was in "a previous node".

The point of hyperlinking is to start with text that makes sense even without any hyperlinks, and then add links so that parts of the text magically take you to some place related to that text.

Misunderstanding this principle leads us to write "click here" style links, which mean nothing and actually detracts. Don't say "For more information, click here". Instead, write "For more information, see the detailed description". Not only will that read correctly in absence of a web browser (such as when printed), it even makes a somewhat self-documenting book mark: "the detailed description" vs "click here".

-- Randal L. Schwartz, Perl hacker
Be sure to read my standard disclaimer if this is a reply.


update: Apparently 456bereastreet agrees with me.
  • Comment on On good hyperlinking (was Re: Config Files Redux)

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others lurking in the Monastery: (3)
As of 2021-10-23 17:49 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?
    My first memorable Perl project was:







    Results (88 votes). Check out past polls.

    Notices?