Customizability vs. Shipping a Good Product

David Miller justdave at
Wed Aug 15 18:24:13 UTC 2007

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
>> 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                         
System Administrator, Mozilla Corporation
Project Leader, Bugzilla Bug Tracking System

More information about the developers mailing list