docs_urlbase

[David Lawrence]

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.

dkl

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:
>>
>>   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
> -
> To view or change your list settings, click here:
> <http://bugzilla.org/cgi-bin/mj_wwwusr?user=$MSGRCPT>

-- 
David Lawrence
dkl at mozilla.com
bugzilla.mozilla.org

_______________________________________________
dev-apps-bugzilla mailing list
dev-apps-bugzilla at lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-apps-bugzilla