docs_urlbase

Gervase Markham gerv at mozilla.org
Wed Dec 17 12:52:50 UTC 2014


On 17/12/14 11:22, Frédéric Buclin wrote:
> You are 7 years and a lot of Bugzilla meetings behind:
> 
>   https://bugzilla.mozilla.org/show_bug.cgi?id=399068

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 lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-apps-bugzilla


More information about the developers mailing list