Граф коммитов

169 Коммитов

Автор SHA1 Сообщение Дата
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