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: