Closed Bug 1125666 Opened 11 years ago Closed 10 years ago

Page not found for localized documentation on readthedocs.org

Categories

(Bugzilla :: Documentation, defect)

Product:
Bugzilla
Component:
Documentation
Platform:
x86
Linux
Type:
defect
Priority:
Not set
Severity:
normal

Tracking

()

Status:
RESOLVED WORKSFORME

People

(Reporter: bmo.cec, Unassigned)

Details

When the localized documentation is not compiled locally, help links are redirected to RTD. For the French documentation, it is currently redirected to https://bugzilla.readthedocs.org/fr/5.0/ which is 404. Up-to-date French documentation are currently on http://bugzilla-fr.readthedocs.org/fr/BUGZILLA_5_0RC1/ Apparently, RTD uses the DVCS tag to build the path. How should I proceed for the next releases to avoid 404? If it can help, I have a Bugzilla test installation with French templates: https://bz50.bugzilla.fr/ Thanks
Assignee: general → documentation
Component: Bugzilla-General → Documentation
On the Versions page in RTD, you can change which tags and versions from your documentation VCS repo are built: https://readthedocs.org/dashboard/bugzilla-fr/versions/ You need to make sure you are using tags which match the ones we use in the upstream repo, and then you need to make sure the tags we are building are also the ones you are building (check the "Active" checkbox). We are currently building "latest" and "5.0". "5.0" corresponds to the tip of the 5.0 stable branch, not to a particular release (e.g. 5.0rc1). We thought it was best to do the documentation that way, so docs fixes on stable branches are shipped immediately. Gerv
Cédric: does that solve your problem? Gerv
Sorry, I was busy for a few days. I already figured out how to select the tags on RTD. I was expecting a "cleaner" way than following the tag naming policy from the en_US repository. For my case, I will use double tag: one tag for my personal needs and the one used in en_US repository. (I'm using a Mercurial repository by the way, hosted on sf.net). Currently Sourceforge.net is experiencing difficulties, so I cannot validate this solution. I will let you know as soon as I can commit on sf.net.
It works: the doc link on https://bz50.bugzilla.fr/ redirects on https://bugzilla.readthedocs.org/fr/5.0/using/index.html which is displayed correctly. I guess we can close this bug as FIXED.
Status: NEW → RESOLVED
Closed: 10 years ago
Resolution: --- → WORKSFORME
You need to log in before you can comment on or make changes to this bug.