Dcumentation advice

Pedro Szekely ([email protected])
Fri, 30 Jun 1995 09:00:20 PDT

Hi,

When writing the HTML for the documentation, please only use relative
references for hyperlinks. Ie, use things like
<A HREF="pres.html#Presentation">Presentation</A>
rather than
<A HREF="http://isd/Mastermind/Documentation/pres.html#Presentation">..

The idea is to not use http://.... unless it is used to refer to a document
that is not part of the documentation.

If we keep to relative references, then people can easily download all the
documentation source files into their machine, and get much faster access.
Also, the documentation can be downloaded into machines that have no access to
an HTML server (e.g., a laptop), and you can still use the browser to look at
the documentation.

Pedro Szekely
USC/ISI, 4676 Admiralty Way, Marina del Rey, CA 90292
Phone: 310/822-1511, Fax: 310/823-6714
URL: http://www.isi.edu/isd/szekely.html