1877915 - Perma Documentation ./mach doc | Error: 5 new warnings have been introduced compared to the limit in docs/config.yml

Status: RESOLVED FIXED

(NSS :: Documentation, defect, P3)

Description

[Treeherder Bug Filer]

Filed by: sstanca [at] mozilla.com
Parsed log: https://treeherder.mozilla.org/logviewer?job_id=445447706&repo=mozilla-central
Full log: https://firefox-ci-tc.services.mozilla.com/api/queue/v1/task/S5PK--CkQR6NGsXZ3f56ew/runs/0/artifacts/public/logs/live_backing.log

---

[task 2024-02-01T05:43:29.726Z] copying images... [ 98%] toolkit/search/assets/search-service-diagram.png
[task 2024-02-01T05:43:29.726Z] copying images... [ 98%] tools/profiler/profilerclasses-20220913.png
[task 2024-02-01T05:43:29.726Z] copying images... [ 98%] tools/profiler/profilerthreadregistration-20220913.png
[task 2024-02-01T05:43:29.727Z] copying images... [ 98%] tools/profiler/fissionprofiler-20200424.png
[task 2024-02-01T05:43:29.727Z] copying images... [ 98%] tools/try/img/phab-treeherder-link.png
[task 2024-02-01T05:43:29.727Z] copying images... [ 98%] tools/try/img/add-new-jobs.png
[task 2024-02-01T05:43:29.728Z] copying images... [ 98%] tools/try/selectors/fzf.png
[task 2024-02-01T05:43:29.728Z] copying images... [ 99%] widget/windows/windows-pointing-device/touchscreen.jpg
[task 2024-02-01T05:43:29.728Z] copying images... [ 99%] widget/windows/windows-pointing-device/wacom_tablet.png
[task 2024-02-01T05:43:29.729Z] copying images... [ 99%] widget/windows/windows-pointing-device/trackpoint.jpg
[task 2024-02-01T05:43:29.729Z] copying images... [ 99%] widget/windows/windows-pointing-device/touchpad.jpg
[task 2024-02-01T05:43:29.729Z] copying images... [ 99%] widget/windows/windows-pointing-device/vrcontroller.jpg
[task 2024-02-01T05:43:29.729Z] copying images... [ 99%] widget/windows/windows-pointing-device/apple_vision.jpg
[task 2024-02-01T05:43:29.729Z] copying images... [ 99%] widget/windows/windows-pointing-device/mouse.jpg
[task 2024-02-01T05:43:29.730Z] copying images... [100%] widget/windows/windows-pointing-device/touch_media_queries.png
[task 2024-02-01T05:43:29.730Z] 
[task 2024-02-01T05:43:29.747Z] copying static files... done
[task 2024-02-01T05:43:29.747Z] copying extra files... done
[task 2024-02-01T05:43:30.591Z] dumping search index in English (code: en)... done
[task 2024-02-01T05:43:30.691Z] dumping object inventory... done
[task 2024-02-01T05:43:30.692Z] build succeeded, 831 warnings.
[task 2024-02-01T05:43:30.692Z] 
[task 2024-02-01T05:43:30.692Z] The HTML pages are in docs-out/html.
[task 2024-02-01T05:43:30.716Z] TEST-UNEXPECTED-FAILURE | ./mach doc | Error: 5 new warnings have been introduced compared to the limit in docs/config.yml
[task 2024-02-01T05:43:30.716Z] 
[task 2024-02-01T05:43:30.716Z] Generated documentation:
[task 2024-02-01T05:43:30.716Z] docs-out/html
[task 2024-02-01T05:43:30.716Z] Logged 764 warnings
[task 2024-02-01T05:43:30.716Z] 
[taskcluster 2024-02-01 05:43:36.774Z] === Task Finished ===
[taskcluster 2024-02-01 05:43:36.926Z] Artifact "public/docs.tar.gz" not found at "/builds/worker/checkouts/gecko/docs-out/main.tar.gz"
[taskcluster 2024-02-01 05:43:37.007Z] Artifact "public/trees.json" not found at "/builds/worker/artifacts/trees.json"
[taskcluster 2024-02-01 05:43:37.029Z] Unsuccessful task run with exit code: 1 completed in 314.514 seconds

Comment 1

[Serban Stanca [:SerbanS]]

This popped up after this push landed on Autoland.

Hello John! Could you please take a look at this?

Thank you!

Comment 2

[John Schanck [:jschanck]]

Kai, I think this is due to Bug 1866832.

Comment 3

[Intermittent Failures Robot]

19 failures in 656 pushes (0.029 failures/push) were associated with this bug yesterday.

Repository breakdown:

• autoland: 6
• mozilla-central: 13

Platform and build breakdown:

• doc: 19
  • opt: 19

For more details, see:
https://treeherder.mozilla.org/intermittent-failures/bugdetails?bug=1877915&startday=2024-02-02&endday=2024-02-02&tree=all

Comment 4

[Intermittent Failures Robot]

33 failures in 3952 pushes (0.008 failures/push) were associated with this bug in the last 7 days.

** This failure happened more than 30 times this week! Resolving this bug is a high priority. **

** Try to resolve this bug as soon as possible. If unresolved for 2 weeks, the affected test(s) may be disabled. **

Repository breakdown:

• autoland: 10
• mozilla-central: 23

Platform and build breakdown:

• doc: 33
  • opt: 33

For more details, see:
https://treeherder.mozilla.org/intermittent-failures/bugdetails?bug=1877915&startday=2024-01-29&endday=2024-02-04&tree=all

Comment 5

[Mark Banner (:standard8)]

Please can this be looked at soon? This is a permanent failure on a tier 2 task, which also causes warnings to be put on everyone's phabricator pushes.

I compared the logs and the new warnings are:

[task 2024-02-01T00:08:01.644Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:20: CRITICAL: Unexpected section title or transition.
[task 2024-02-01T00:08:01.644Z] 
[task 2024-02-01T00:08:01.644Z] --------------
[task 2024-02-01T00:08:01.644Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:24: WARNING: Inline interpreted text or phrase reference start-string without end-string.
[task 2024-02-01T00:08:01.645Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:26: WARNING: Definition list ends without a blank line; unexpected unindent.
[task 2024-02-01T00:08:01.645Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:463: WARNING: Inline strong start-string without end-string.
[task 2024-02-01T00:08:01.645Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:439: ERROR: Unknown target name: "ssl".
[task 2024-02-01T00:08:01.645Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:447: ERROR: Unknown target name: "ssl".
[task 2024-02-01T00:08:01.645Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:487: ERROR: Unknown target name: "ssl".
[task 2024-02-01T00:08:01.645Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:503: ERROR: Unknown target name: "ssl".
[task 2024-02-01T00:08:01.645Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:539: ERROR: Unknown target name: "ssl_error".
[task 2024-02-01T00:08:01.645Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:575: ERROR: Unknown target name: "ssl_error".
[task 2024-02-01T00:08:01.645Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:583: ERROR: Unknown target name: "ssl".
[task 2024-02-01T00:08:01.645Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:591: ERROR: Unknown target name: "ssl_error".
[task 2024-02-01T00:08:01.646Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:626: ERROR: Unknown target name: "ssl_error".
[task 2024-02-01T00:08:01.646Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:718: ERROR: Unknown target name: "ssl".
[task 2024-02-01T00:08:01.646Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:743: ERROR: Unknown target name: "ssl_error".
[task 2024-02-01T00:08:01.646Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:750: ERROR: Unknown target name: "ssl_error".
[task 2024-02-01T00:08:01.646Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:1007: ERROR: Unknown target name: "sec".
[task 2024-02-01T00:08:01.646Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:1237: ERROR: Unknown target name: "sec".
[task 2024-02-01T00:08:01.646Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:1296: ERROR: Unknown target name: "sec".
[task 2024-02-01T00:08:01.646Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:1309: ERROR: Unknown target name: "sec".
[task 2024-02-01T00:08:01.646Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:1337: ERROR: Unknown target name: "sec".
[task 2024-02-01T00:08:01.647Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:1349: ERROR: Unknown target name: "sec_error".
[task 2024-02-01T00:08:01.647Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:1384: ERROR: Unknown target name: "sec".
[task 2024-02-01T00:08:01.647Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:1399: ERROR: Unknown target name: "sec".
[task 2024-02-01T00:08:01.647Z] /builds/worker/checkouts/gecko/docs-out/html/_staging/security/nss/error_codes.rst:4: WARNING: duplicate label error codes, other instance in /builds/worker/checkouts/gecko/docs-out/html/_staging/nspr/reference/nspr_error_handling.rst

Comment 6

[Kai Engert (:KaiE:)]

Let's back it out.

I didn't expect the change of NSS docs to have that impact, and as we're learning, the legacy docs need tweaking before they work well.

Comment 7

[Kai Engert (:KaiE:)]

Backed out from NSS. A new NSS snapshot needs to be uplifted as part of bug 1875764 for this fix to arrive in m-c.

Comment 8

[Mark Banner (:standard8)]

This is now fixed since bug 1875764 comment 7 landed the backout on central.

Thank you all.

Comment 9

[Intermittent Failures Robot]

8 failures in 4009 pushes (0.002 failures/push) were associated with this bug in the last 7 days.

Repository breakdown:

• autoland: 5
• mozilla-central: 3

Platform and build breakdown:

• doc: 8
  • opt: 8

For more details, see:
https://treeherder.mozilla.org/intermittent-failures/bugdetails?bug=1877915&startday=2024-02-05&endday=2024-02-11&tree=all