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

Re: should XML/SGML documentation ship with sources

On Tue, Dec 10, 2002 at 11:23:41PM +1100, Brendan O'Dea wrote:
> >Is it a good practice for SGML or XML documentation to ship with
> >source?
> My preference would be to include the source plus both text and html
> renderings.  This provides both convieniently pre-formated output for
> on-line viewing plus the ability to generate hard-copy for the user's
> specific output device requirements (paper and printer type).

The problem is that this generation is not guaranteed to work, due to
various intricate details of document build systems.

     2. That which causes joy or happiness.

Reply to: