Eric Engestrom
2156ea8ec7
docs/ci: drop .no_scheduled_pipelines-rules from test-docs
...
None of the existing rules can match in a scheduled pipeline, so we already `never` run.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29908 >
2024-06-26 20:25:39 +00:00
Eric Engestrom
aba6bf7765
docs/ci: auto-run test-docs in fork pipelines
...
Since it's gated on a manual container job already.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29908 >
2024-06-26 20:25:39 +00:00
Eric Engestrom
d48c91c582
docs/ci: merge test-docs and test-docs-mr
...
No reason to have two different jobs, they both do exactly the same
thing with just different rules for existing.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29908 >
2024-06-26 20:25:39 +00:00
Eric Engestrom
5e44b4b123
docs/ci: fix indentation of list nested in a dict item
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29908 >
2024-06-26 20:25:39 +00:00
Erik Faye-Lund
fdd204538b
ci: build docs using meson
...
To avoid having to inflate the image here even further, let's just add
what we need to the the normal x86 Alpine build image, and use that.
Reviewed-by: Daniel Stone <daniels@collabora.com >
Reviewed-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/11494 >
2024-06-25 10:59:54 +00:00
David Heidelberg
180cb30986
ci/docs: add coreutils
...
Needed for correct GitLab CI `date` variable parsing.
Closes: https://gitlab.freedesktop.org/mesa/mesa/-/issues/10041
Signed-off-by: David Heidelberg <david.heidelberg@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25917 >
2023-10-30 19:16:19 +00:00
Eric Engestrom
49395b4aa4
docs/ci: allow sanity job to be missing
...
The rules of both jobs never matched, so there was always the potential
for the job to be missing, but it's about to get worse with the next
commit, so fix that now.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25920 >
2023-10-30 17:50:56 +00:00
Erik Faye-Lund
bbd6ef4d34
docs: remove breathe/doxygen stuff
...
Reviewed-by: Jani Nikula <jani@nikula.org >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/24507 >
2023-10-26 16:13:26 +00:00
Erik Faye-Lund
67485efd65
docs: prepare for hawkmoth
...
Hawkmoth is a Sphinx-extension that uses Clang to directly parse C code
for automatic documentation of C/C++ code, similar to what Doxygen does.
However, Doxygen is rather clunky to integrate into the build process,
so let's start switching over to Hawkmoth instead.
As Sphinx does not have syntax for describing parameter direction, add
an rst_prolog with rst replacements for them.
Reviewed-by: Jani Nikula <jani@nikula.org >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/24507 >
2023-10-26 16:13:25 +00:00
Eric Engestrom
632792eca0
ci/docs: drop extra overwritten rules
...
Every job re-defines its own rules, so there is no point in including these here.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25307 >
2023-09-27 10:05:37 +01:00
Eric Engestrom
9618fefd18
ci: unify container and build jobs rules
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25294 >
2023-09-26 18:06:23 +00:00
Erik Faye-Lund
9aefd97cfd
docs: use custom html theme
...
This uses the new custom HTML theme for Sphinx, so our documentation
looks similar to our website.
Reviewed-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8399 >
2023-04-26 22:45:41 +00:00
Emma Anholt
c346413d9c
ci: Add missing dependency on doxygen sources for docs-generation jobs.
...
!22191 broke docs generation and marge didn't notice because of missing
deps.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22271 >
2023-04-04 20:00:17 +00:00
Erik Faye-Lund
859bcd605d
ci: move docs-stuff out of root .gitlab-ci.yml
...
Unlike most other cases, we don't put the YAML-file in a ci-folder,
because we already have one for the CI-specific docs. So let's just
leave the YAML file directly in the docs-folder.
This should fix the problem that any docs-changes that touches the
CI-rules needs a full CI run just because of touching the root
.gitlab-ci.yml file. This causes needless friction and wastes CI
resources.
Reviewed-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/21953 >
2023-03-20 15:27:37 +00:00
