Georg Fritzsche [:gfritzsche] Reporter
	Description • 9 years ago

We are missing documentation for aborted-session in the in-tree documentation (in main-ping.rst).

	Georg Fritzsche [:gfritzsche] Reporter
	Comment 1 • 9 years ago

I'm not seeing it listed with the reasons here:
https://ci.mozilla.org/job/mozilla-central-docs/Tree_Documentation/

... even though there is:
https://dxr.mozilla.org/mozilla-central/source/toolkit/components/telemetry/docs/main-ping.rst#10

	Alessio Placitelli [:Dexter]
	Comment 2 • 9 years ago

It appears that the documentation is not getting built correctly since March 19th (https://ci.mozilla.org/job/mozilla-central-docs/) and the doc changes landed on the 24th.

	Alessio Placitelli [:Dexter]
	Comment 3 • 9 years ago

That's an extract from the first failing build:

" 0:51.76 configure: error: Only GCC 4.7 or newer supported
 0:51.76 *** Fix above errors and then restart with\
 0:51.77                "/usr/bin/make -f client.mk build"
 0:51.77 make: *** [configure] Error 1
Build step 'Execute shell' marked build as failure
Archiving artifacts
[htmlpublisher] Archiving HTML reports...
[htmlpublisher] Archiving at PROJECT level /var/lib/jenkins/jobs/mozilla-central-docs/workspace/tree-docs/html to /var/lib/jenkins/jobs/mozilla-central-docs/htmlreports/Tree_Documentation
Finished: FAILURE"

Full log here: https://ci.mozilla.org/job/mozilla-central-docs/2679/console

	Georg Fritzsche [:gfritzsche] Reporter
	Comment 4 • 9 years ago

I am not quite sure where this should go.
mgerva, maybe you know who owns this?

	Massimo Gervasini [:massimo]
	Comment 5 • 9 years ago

I think gps set this up. gps can you help us?

	Gregory Szorc [:gps]
	Comment 6 • 9 years ago

Try https://gecko.readthedocs.org/.

Fixing ci.mozilla.org will require updating the Ubuntu base image in tools/docs/Vagrantfile.

	Gregory Szorc [:gps]
	Comment 7 • 9 years ago

When `mach build-docs` was first implemented, we needed a full `mach configure` to run it. That requirement vanished in bug 1091722. However, the job in ci.mozilla.org was still running `mach configure`. And, when the minimum GCC version was recently bumped past what was installed in the VM, the job broke.

I have removed `mach configure` from the Jenkins job configuration. The job is now working again. So calling this resolved.

FWIW, the scripts to do the docs building should really be checked into tree. I'm pretty sure there's a bug on that somewhere.