Mark Banner
79eeee2f4e
Bug 1864608 - Switch document generation warnings to use an allow list of known warnings, and output new ones as errors. r=sylvestre
...
This removes the separate handling of different types of warnings/failures, and switches to an allow list of warnings that are the existing ones. They'll still be output as TEST-KNOWN-FAIL. Any new warnings will be output as TEST-UNEXPECTED-FAIL and cause the document generation/upload to fail.
Differential Revision: https://phabricator.services.mozilla.com/D225973
2024-10-28 08:54:09 +00:00
Francesco Lodolo (:flod)
722e67d046
Bug 1916932 - Move RST linter configuration to file, fix or ignore local errors with code blocks r=sylvestre
...
Differential Revision: https://phabricator.services.mozilla.com/D221113
2024-09-05 11:55:00 +00:00
Mark Banner
a94fcf9719
Bug 1916093 - Make 'fatal' warnings during documentation raise errors by default. r=sylvestre
...
Differential Revision: https://phabricator.services.mozilla.com/D220765
2024-09-03 18:48:45 +00:00
Mark Banner
1930a2a863
Bug 1916093 - When generating docs, treat critical errors the same as errors. r=sylvestre,perftest-reviewers,sparky
...
Differential Revision: https://phabricator.services.mozilla.com/D220764
2024-09-03 18:48:45 +00:00
Mark Banner
d8cd7314ef
Bug 1875389 - Properly exclude python test files from doc generation. r=sylvestre
...
Differential Revision: https://phabricator.services.mozilla.com/D220629
2024-09-02 14:38:08 +00:00
Mark Banner
fee9dd7be0
Bug 1915550 - Make ERRORS raised during 'mach doc generate' be failures. r=sylvestre
...
Differential Revision: https://phabricator.services.mozilla.com/D220535
2024-09-02 14:38:08 +00:00
Stanca Serban
1ff77350d5
Backed out 2 changesets (bug 1910311
) as requested by Sylvestre.
...
Backed out changeset 5b8997293aaa (bug 1910311
)
Backed out changeset d9bfe8fcbecf (bug 1910311
)
2024-07-30 11:55:46 +03:00
Sylvestre Ledru
2c495330f8
Bug 1910311
- ride along: fix sphinx warnings r=firefox-source-docs-reviewers,ahal DONTBUILD
...
tools/moztreedocs/__init__.py:35: RemovedInSphinx80Warning: Sphinx 8 will drop support for representing paths as strings. Use "pathlib.Path" or "os.fspath" instead.
is_main = docdir == MAIN_DOC_PATH
Differential Revision: https://phabricator.services.mozilla.com/D217912
2024-07-29 18:58:50 +00:00
ahochheiden
e7e2018aab
Bug 1887885 - Collect the target architecture of a build r=firefox-build-system-reviewers,glandium
...
Added one field:
- The `--target` of a build.
Re-added `python/mach/metrics.yaml` to `./mach doc mach-telemetry` generation (Not sure why it was missing).
Re-generated the associated docs. (It looks like this was not done for previously when other fields were added.
Differential Revision: https://phabricator.services.mozilla.com/D208811
2024-07-09 19:57:45 +00:00
Jesse Schwartzentruber
5a3734d3ef
Bug 1903620 - Calculate jobs using CPU affinity in mach. r=firefox-build-system-reviewers,glandium
...
Differential Revision: https://phabricator.services.mozilla.com/D214289
2024-06-25 13:53:13 +00:00
Mark Banner
f7d0d6476b
Bug 1890668 - Add note regarding enabling ESLint rules to the jsdoc support document. r=sylvestre
...
Differential Revision: https://phabricator.services.mozilla.com/D207081
2024-04-23 12:25:07 +00:00
Logan Rosen
568a9b76b6
Bug 1854149 - upgrade to Sphinx 7.1.2 r=sylvestre,firefox-source-docs-reviewers DONTBUILD
...
Differential Revision: https://phabricator.services.mozilla.com/D189725
2024-03-21 18:24:18 +00:00
Andrew Halberstadt
393672d628
Bug 1867848 - [docs] Stop processing Markdown frontmatter, r=firefox-source-docs-reviewers,necko-reviewers,mach-reviewers,championshuttler,valentin,sylvestre,ahochheiden
...
Differential Revision: https://phabricator.services.mozilla.com/D195284
2023-12-04 21:26:13 +00:00
Mark Banner
9cb3cd6f0a
Bug 1865208 - Add missing included files to fatal warnings for document generation. r=sylvestre
...
Differential Revision: https://phabricator.services.mozilla.com/D193842
2023-11-17 11:43:47 +00:00
Mark Banner
ae93348042
Bug 1861953 - Improve mach doc errors so that they show up on treeherder summaries. r=sylvestre
...
Differential Revision: https://phabricator.services.mozilla.com/D193243
2023-11-10 14:17:28 +00:00
serge-sans-paille
65ae75234f
Bug 1857516 - Get rid of deprecated imp python module in favor of importlib r=saschanaz CLOSED TREE
...
Following the official migration guide from
https://docs.python.org/3/whatsnew/3.12.html#imp
Differential Revision: https://phabricator.services.mozilla.com/D190465
2023-10-17 09:17:47 +00:00
Norisz Fay
1aa4e4dfed
Backed out changeset 7f8e4fcfcbfa (bug 1857516) for causing web platform test failures CLOSED TREE
2023-10-17 13:33:51 +03:00
serge-sans-paille
2043e40f57
Bug 1857516 - Get rid of deprecated imp python module in favor of importlib r=saschanaz
...
Following the official migration guide from
https://docs.python.org/3/whatsnew/3.12.html#imp
Differential Revision: https://phabricator.services.mozilla.com/D190465
2023-10-17 09:17:47 +00:00
Logan Rosen
f024d94b2b
Bug 1786490
- reformat the tree using black 23.3.0 r=sylvestre,webdriver-reviewers,taskgraph-reviewers,whimboo,jmaher,ahal,perftest-reviewers,geckoview-reviewers,afinder,m_kato
...
# ignore-this-changeset
Differential Revision: https://phabricator.services.mozilla.com/D186092
2023-09-06 16:14:30 +00:00
Sylvestre Ledru
9dde27ae07
no bug - mozlint/ruff: log.debug the arguments r=linter-reviewers,ahal DONTBUILD
...
Differential Revision: https://phabricator.services.mozilla.com/D179371
2023-06-02 13:39:57 +00:00
Sylvestre Ledru
854d40a127
no bug - contrib doc: update a bit the content r=firefox-source-docs-reviewers,marco DONTBUILD
...
Depends on D173639
Differential Revision: https://phabricator.services.mozilla.com/D173640
2023-04-01 13:27:26 +00:00
Andrew Halberstadt
577c4dacfe
Bug 1811850 - [lint] Fix ruff errors resulting from new configuration, r=webdriver-reviewers,perftest-reviewers,whimboo,sparky,firefox-build-system-reviewers,ahochheiden
...
# ignore-this-changeset
Differential Revision: https://phabricator.services.mozilla.com/D172359
2023-03-20 13:06:28 +00:00
Cristian Tuns
c1b52fd95e
Backed out 5 changesets (bug 1811850) for causing linting bustages(bugzilla) CLOSED TREE
...
Backed out changeset e8fcfc7f8108 (bug 1811850)
Backed out changeset f8950d716c9e (bug 1811850)
Backed out changeset f650123cc188 (bug 1811850)
Backed out changeset d96f90c2c58b (bug 1811850)
Backed out changeset c3b0f9666183 (bug 1811850)
2023-03-16 22:16:30 -04:00
Andrew Halberstadt
d93be6a402
Bug 1811850 - [lint] Fix ruff errors resulting from new configuration, r=webdriver-reviewers,perftest-reviewers,whimboo,sparky,firefox-build-system-reviewers,ahochheiden
...
# ignore-this-changeset
Differential Revision: https://phabricator.services.mozilla.com/D172359
2023-03-17 01:54:00 +00:00
Manuel Bucher
57313a9e03
Bug 1820505 - Document how to create mermaid diagrams in markdown r=firefox-source-docs-reviewers,ahal DONTBUILD
...
Differential Revision: https://phabricator.services.mozilla.com/D171697
2023-03-13 09:39:50 +00:00
ogiorgis
29b5739905
Bug 1803426 - remove useless requirements.in file r=firefox-source-docs-reviewers,sylvestre DONTBUILD
...
In
https://hg.mozilla.org/mozilla-central/rev/89fcec6bc22dc5e5d31491f76c4dd13c5c3d4722
we switched over to the new sites system.
Differential Revision: https://phabricator.services.mozilla.com/D168516
2023-02-21 14:28:55 +00:00
ogiorgis
05f74446e5
Bug 1812560 - Allow mach doc to build subdirectories of doc r=firefox-source-docs-reviewers,ahal DONTBUILD
...
Depends on D169094
Differential Revision: https://phabricator.services.mozilla.com/D170075
2023-02-18 08:26:34 +00:00
ogiorgis
f2ae383672
Bug 1812560 - Accept all directories containing an index file for 'mach doc' r=firefox-source-docs-reviewers,ahal DONTBUILD
...
The presence of an index file is a better criterion than the name of the directory.
Differential Revision: https://phabricator.services.mozilla.com/D169094
2023-02-17 13:33:50 +00:00
ogiorgis
1a578e35ae
Bug 1678710 - Add a warning when creating the entire docs r=firefox-source-docs-reviewers,ahal DONTBUILD
...
Differential Revision: https://phabricator.services.mozilla.com/D169077
2023-02-17 13:33:50 +00:00
Carine Dengler
8500e18b77
Bug 1703037 - Add a no-python option to `./mach doc` r=firefox-source-docs-reviewers,sylvestre DONTBUILD
...
Differential Revision: https://phabricator.services.mozilla.com/D168352
2023-02-17 13:26:24 +00:00
cdengler
3a2b24f085
Bug 1807831 - Add a check to make sure that we don't regress the number of warnings r=sylvestre,ahal DONTBUILD
...
Differential Revision: https://phabricator.services.mozilla.com/D167528
2023-01-23 16:49:17 +00:00
ogiorgis
1dfa7e23a3
Bug 1557020 - Don't remove unaccounted files while building docs r=sylvestre
...
While copying sphinx files, some unmodified static files were deleted.
Differential Revision: https://phabricator.services.mozilla.com/D167397
2023-01-23 16:40:07 +00:00
Sylvestre Ledru
62b73ca40c
Bug 1750450 - Doc: use the new system for python deps r=firefox-source-docs-reviewers,ahal
...
Co-author: Andrew Halberstadt <ahal@mozilla.com>
Differential Revision: https://phabricator.services.mozilla.com/D153483
2023-01-05 14:32:11 +00:00
Sylvestre Ledru
be30477567
no bug - document how the firefox source doc system work r=firefox-source-docs-reviewers,marco DONTBUILD
...
Differential Revision: https://phabricator.services.mozilla.com/D165624
2023-01-03 14:00:37 +00:00
Sylvestre Ledru
c280fd9621
no bug - document reviewbot behavior when the doc is modified r=andi DONTBUILD
...
Differential Revision: https://phabricator.services.mozilla.com/D165623
2022-12-30 17:16:02 +00:00
Sylvestre Ledru
31a10662a8
no bug - doc: add 'error:' when the doc is failing to build r=firefox-source-docs-reviewers,marco DONTBUILD
...
Differential Revision: https://phabricator.services.mozilla.com/D165626
2022-12-29 16:00:14 +00:00
Marco Castelluccio
f69e697461
Bug 1801836 - Remove no longer necessary 'from __future__' imports. r=linter-reviewers,glandium,webdriver-reviewers,perftest-reviewers,geckoview-reviewers,jld,ahal,owlish,afinder DONTBUILD
...
Differential Revision: https://phabricator.services.mozilla.com/D165395
2022-12-23 22:45:46 +00:00
Sylvestre Ledru
42ae364fef
Bug 1802924 - doc: Update rtd-theme to 1.1.1 r=firefox-source-docs-reviewers,marco
...
Differential Revision: https://phabricator.services.mozilla.com/D165093
2022-12-20 18:28:52 +00:00
Sylvestre Ledru
a9da3ee623
Bug 1763971 - Update sphinx-js to allow build with python 3.10 r=firefox-source-docs-reviewers,ahal
...
Depends on D165092
Differential Revision: https://phabricator.services.mozilla.com/D164963
2022-12-20 18:28:51 +00:00
Cosmin Sabou
f4b3682389
Backed out changeset 65695f7ddf1d (bug 1750450) for causing python3 failures.
2022-12-20 17:03:20 +02:00
Sylvestre Ledru
3929f16a60
Bug 1750450 - Doc: use the new system for python deps r=firefox-source-docs-reviewers,ahal
...
+ update sphinx-js to 3.2.1
Differential Revision: https://phabricator.services.mozilla.com/D153483
2022-12-20 12:53:56 +00:00
Norisz Fay
081bdcdf0c
Backed out changeset c41cb5ac4dbd (bug 1806098) for causing lint failures on lints.py, isort.py CLOSED TREE
2022-12-16 18:13:59 +02:00
Sylvestre Ledru
c55679e14a
Bug 1806098 - Enable pylint on tools/lint/ & tools/moztreedocs/ r=jlorenzo,linter-reviewers,marco DONTBUILD
...
Differential Revision: https://phabricator.services.mozilla.com/D164894
2022-12-16 14:07:46 +00:00
Marian-Vasile Laza
bd86ea8fb1
Backed out 3 changesets (bug 1802924) for causing doc generate failures. CLOSED TREE
...
Backed out changeset e878329a42ea
Backed out changeset 8621c76e4e95 (bug 1802924)
Backed out changeset c5b12cce19be
2022-11-28 19:38:56 +02:00
Sylvestre Ledru
5788f06dec
no bug - update sphinx-markdown-tables & markdown r=firefox-source-docs-reviewers,marco
...
Differential Revision: https://phabricator.services.mozilla.com/D163237
2022-11-28 17:11:50 +00:00
Sylvestre Ledru
47ffe7325a
Bug 1802924 - Update to sphinx-rtd-theme 1.1.1 r=firefox-source-docs-reviewers,marco
...
Differential Revision: https://phabricator.services.mozilla.com/D163234
2022-11-28 17:11:50 +00:00
Sylvestre Ledru
1d302c148a
no bug - Update dependency sphinx-copybutton to v0.5.1 r=firefox-source-docs-reviewers,marco
...
Differential Revision: https://phabricator.services.mozilla.com/D163232
2022-11-28 17:11:48 +00:00
Marco Castelluccio
de29bc2f0e
Bug 1790816 - Reformat tools/ with isort. r=linter-reviewers,perftest-reviewers,sparky,sylvestre DONTBUILD
...
# ignore-this-changeset
Differential Revision: https://phabricator.services.mozilla.com/D162660
2022-11-24 10:58:05 +00:00
Andrew Halberstadt
de09eb129e
Bug 1799760 - [docs] Ensure warnings are non-fatal when running locally, r=firefox-source-docs-reviewers,marco
...
When running `./mach doc` locally it is a poor experience to have the build error out
due to fatal warnings, as it's possible the missing refs simply aren't implemented yet.
Or worse, it's possible that the developer ran `./mach doc <subtree>` and the missing
refs don't exist simply because they are outside of <subtree>.
This patch ensures we only enable fatal warnings in CI, or if the user opts into it with
the `--fatal-warnings` flag.
Differential Revision: https://phabricator.services.mozilla.com/D161633
2022-11-10 19:09:16 +00:00
Andrew Halberstadt
6fcdd883c0
Bug 1458882 - [moztreedocs] Add flag to dump sphinx trees to a file, r=firefox-source-docs-reviewers,sylvestre
...
This will enable tools like searchfox to map source files in the
tree to their rendered URLs.
Differential Revision: https://phabricator.services.mozilla.com/D157929
2022-11-01 21:03:07 +00:00