David Lawrence dkl at
Wed Dec 17 15:37:42 UTC 2014

Well in any case, we should definitely do #1 anyway as people will want to know how to
compile and host their own docs. As for #3, I am not sure how admins feel about Bugzilla
redirecting to external hosts by default that they do not control. I agree also that by leaving the
docs_urlbase pointing to local paths by default gives a bad out-of-box experience for Bugzilla when
they keep getting 404's.

What if we make the docs_urlbase one of the "must-set" params that show up when a admin
accesses a new Bugzilla instance for the first time? Then we can have the param's description
explain the different choices giving the option to just use ReadTheDocs if desired.


On 12/17/2014 07:52 AM, Gervase Markham wrote:
> On 17/12/14 11:22, Frédéric Buclin wrote:
>> You are 7 years and a lot of Bugzilla meetings behind:
> OK :-) I guess I thought "broken Help links by default" was a big enough
> bug that surely it wouldn't be so old...
>>> If that seems like too much for the 5.0 branch
>> Bugzilla never had compiled HTML documentation included, so there is
>> nothing new here. So there is no urge to do it right now for 5.0.
> But all the Help links are broken by default! That's a horrible user
> experience. I think we should definitely either:
> * Document in the installation instructions that people should compile
> the docs;
> or
> * Document in the installation instructions that everyone needs to
> change docs_urlbase (then why not change the default?);
> or
> * Change the default docs_urlbase to ReadTheDocs and document what to
> use for local docs.
> We should surely do one of these things.
> Gerv
> _______________________________________________
> dev-apps-bugzilla mailing list
> dev-apps-bugzilla at
> -
> To view or change your list settings, click here:

David Lawrence
dkl at

dev-apps-bugzilla mailing list
dev-apps-bugzilla at

More information about the developers mailing list