[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Documentation (Re: Attracting newbies)



-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Tuesday 06 February 2007 23:15, Michael Pobega <pobega@gmail.com> 
was heard to say:
> HTML is nice for viewing over the internet, and whenever possible I
> prefer HTML over PDF. Especially since you can tie URLs in HTML to
> other points on the page, so that you can link someone back and
> forth throughout a single page quickly and easily.

HTML is far more flexible than PDF in terms of page width. PDF being 
fixed page width, that is. Makes reading PDF documents very heavy 
work on my Zaurus.

Also, Lynx works for HTML in console/terminal mode, while a PDF is a 
complete loss without a GUI. So indeed, if documentation is to be 
written, HTML beats PDF. If the documentation is in a directory, such 
as /usr/share/doc/foo, there's no worry about including graphics 
since they can simply be included in the same directory.

Nay-sayers are going to ask, "Who doesn't have a GUI?" It's difficult 
to counter that without sounding like an a**hole, but seriously, 
isn't that why there is more than one distribution?

Curt-

- -- 
September 11th, 2001
The proudest day for gun control and central 
planning advocates in American history

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iQEVAwUBRcnIBS9Y35yItIgBAQLwaQf/TnpYdFb3MW3I9AF3pX8zMOh68KVFBmmp
vEEHzMbVaAaJX1erBCFICD6q8Zp7hBOUj3ClZt+26xTwHjsMsjDmNi7vT9OzJcsP
Rd5/EN5DhRtAVqlWd5AP/v1OEHIRNOQUEl7fulaYRRCpg6YPSmrp63jjccFTyYG5
GYD4+zx/TdkeVcsxP7jL7l/kg6zXISX+oTYiAXR9D01zBELBBfvjR7G76LAgY+Y4
rYm6HYd1qulc9kfcEAljCxL2yy7Yj7oOopg0r3kDywXnkh3s98Gr9vPbEnIX6q3S
5JWWT/ogbt1NL7AU8F0w5albwlm2VNoCYkgOJNOIGbUua/uzFoVtVQ==
=0S87
-----END PGP SIGNATURE-----



Reply to: