Customizability vs. Shipping a Good Product

[David Miller]

Gervase Markham wrote on 8/15/07 2:37 AM:
> Frédéric Buclin wrote:
>> Some installations compile their own documentation, some others (which
>> e.g. don't have openjade or all DSSSL librairies installed) point to
>> bugzilla.org or to some other external reference. Having it hardcoded is
>> a mistake. This param is useful as it's used in error messages to give
>> some help to users.
> 
> OK, let me turn the question round. Why do we make _anyone_ compile
> their own documentation? (I seem to remember it being a right pain;
> perhaps it's got easier since.) Why don't we ship the HTML version in
> the tarball? 99% of installs aren't going to modify it; those who do can
> read our docs on how to do so correctly, then recompile it into the same
> location.

The only people that have to compile their own docs are the people who
either 1) check Bugzilla out from CVS, or 2) modify their documentation.

We *do* ship compiled versions in all of the tarballs.

-- 
Dave Miller                                   http://www.justdave.net/
System Administrator, Mozilla Corporation      http://www.mozilla.com/
Project Leader, Bugzilla Bug Tracking System  http://www.bugzilla.org/