[Dojo-interest] Documentation: HTML vs PDF

[Vance Dubberly]

If forced to choose between the two HTML definately as it's easier to
update and I don't have to re-download the documentation everytime a
change is made.

But as many here have said, why the dichotomy? Docbook is a great
place to start, and if that doesn't work ( i've never seen an easy
editor for it)  if the Docs are done in strict XHTML you can XSL:FO
them to pdf. Or one of us can do it.


Vance








On Dec 5, 2007 10:16 AM, Eugene Lazutkin <eugene.lazutkin at gmail.com> wrote:
> It's purely personal preference but I prefer the printed text ---
> somehow I am more productive with it. Not that I am against good
> hyperlinked online documentation, but for the first read, when I have to
> scan the whole text to learn new concepts, and understand the underlying
> ideas I prefer the printed version.
>
> Thanks,
>
> Eugene
>
>
> Daniel wrote:
> > Hello,
> >
> > This is a quick poll/RFC. What would you prefer?:
> >
> > 1. To read the documentation on your web browser.
> > 2. To print the documentation, or read it in PDF.
> >
> > One of the decisions that a Dojo book must make is whether it'll be "Web
> > Oriented" or "Traditional". I'll define these terms:
> >
> > 1. Web oriented: Designed for the browser. Short pages. Many hyper
> > links. More emphasis on browsability. No page numbers. Usually doesn't
> > work so well when printed. Chapters also tend to be shorter.
> >
> > Development tool: Drupal, HTML.
> >
> > 2. Traditional: Designed for the printed page. Works great when printed
> > or as a PDF. Page numbers. You reference other sections with page
> > numbers rather than hyper links. Pages and chapters tend to be longer,
> > more developed. Somewhat less browsable.
> >
> > Development tool: OpenOffice.org
> >
> >
> > You can convert an OOo file to HTML, and you can print an HTML page. But
> > in either case, the result looks awkward. They are different media.
> >
> >
> > Jon has stated a preference for printed documents, because then he can
> > use a highlighter. I would be eager to hear opinions from other
> > documentation readers.
> >
> > Cheers,
> > Daniel.
> > _______________________________________________
> > FAQ: http://dojotoolkit.org/support/faq
> > Book: http://dojotoolkit.org/docs/book
> > Forums: http://dojotoolkit.org/forum
> > Dojo-interest at dojotoolkit.org
> > http://dojotoolkit.org/mailman/listinfo/dojo-interest
> >
>
> _______________________________________________
> FAQ: http://dojotoolkit.org/support/faq
> Book: http://dojotoolkit.org/docs/book
> Forums: http://dojotoolkit.org/forum
> Dojo-interest at dojotoolkit.org
> http://dojotoolkit.org/mailman/listinfo/dojo-interest
>



-- 
To pretend, I actually do the thing: I have therefore only pretended to pretend.
  - Jacques Derrida