Customizability vs. Shipping a Good Product
justdave at bugzilla.org
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
>> 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
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/
More information about the developers