discuss: A note about links in documentation
Subject:
Re: A note about links in documentation
From:
"Mariusz Pekala" ####@####.####
Date:
3 Aug 2001 18:23:35 -0000
Message-Id: <004701c11c49$35dc39a0$0201a8c0@wmbr.com.pl>
Użytkownik "Guylhem Aznar" ####@####.#### napisał w wiadomości ####@####.####
> > In fact I mean the PDF version of a Domain-mini-HOWTO, after I have
> > sent it to the printer and got with me to read in the bus while I am
> > on my way home. :-)
>
> This looks like an error in the linuxdoc sgml or docbook version which
> is tranlated to every file, including pdf.
>
> There are banners saying the URL and the text message that should
> replace it. Obviously, it was not parsed correctly.
Hmm.. I am not sure.. I suppose that the authors are just writing this way.
I have no experience (yet) with DocBook or LinuxDoc, so I cannot check
if my supposition is right, but it seems to me that if I see a link of this form
(in html format - it should be clear what I mean):
... you get it <a href="http://somewhere.org">here</a> ...
then it was just written this way, and not incorrectly parsed by some tool.
I believe that a good style would be if such links (maybe I use the word 'link'
in misleading context? My English isn't perfect...) were typed in similiar way:
(again html style):
...you get it at the <a href="http://somewhere.org">http://somewhere.com</a>...
Maybe it would be good to suggest this kind of links 'citing' in documentation?
Surely it would make happier people that prefer reading from sheets of paper :-)
--Mariusz
--
Jest niezły ... i liścik napisze
OnetKomunikator [ http://ok.onet.pl/instaluj.html ]
