Olivia Lee
a7276d0010
ci: update CI contact list
...
Signed-off-by: Olivia Lee <olivia.lee@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/35521 >
2025-06-13 23:21:37 -07:00
Olivia Lee
e1856d7152
ci: document process for disabling broken farms in more detail
...
Reading the previous version of the docs, I had the impression that the
correct action when a farm is broken is to ping Daniel or Emma in
the #freedesktop channel. I learned that just creating an MR to disable
it immediately is fine, and am documenting this. The farm maintainer
table also wasn't mentioned in the docs previously.
Signed-off-by: Olivia Lee <olivia.lee@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/35521 >
2025-06-13 23:21:37 -07:00
Sergi Blanch Torne
e19e8012e4
docs: crnm: document token usage
...
Judging by comments in the chat, it seems the usage of the tokens in crnm is
only natural when you've been using it for a while. New users would appreciate
reading it in the documentation, beyond the help in the tool.
Also, mentioning how to create a token and what's the minimal scope of the
token to be used with the tool can help new users.
Signed-off-by: Sergi Blanch Torne <sergi.blanch.torne@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/34860 >
2025-06-09 06:06:11 +00:00
Guilherme Gallo
9da1af6eb2
ci/docs: add structured tagging documentation
...
Signed-off-by: Guilherme Gallo <guilherme.gallo@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/33421 >
2025-02-28 01:33:34 +00:00
Eric Engestrom
8364782222
docs: update gitlab docs urls
...
GitLab finally dropped the split between "docs for paid users" and
"docs for free users", and in the process re-shuffled some things.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/33694 >
2025-02-23 00:31:59 +01:00
Erik Faye-Lund
c1cb32ffec
docs: eg. -> e.g.
...
This is how we spell it elsewhere.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29879 >
2024-06-25 10:51:27 +00:00
Erik Faye-Lund
e7b194834d
docs: zink -> Zink
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/29879 >
2024-06-25 10:51:26 +00:00
Eric Engestrom
b65341fd3a
docs/ci: explain how gitlab considers "changes" when pushing on a fork branch
...
And add a workaround for people hitting this unexpected behaviour.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/28809 >
2024-04-19 09:42:42 +00:00
Eric Engestrom
eb96a4bffe
docs: fix syntax highlighting on shell commands
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/27010 >
2024-01-12 08:13:39 +00:00
Eric Engestrom
64c2a0489d
docs: drop : in title
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/26702 >
2023-12-14 22:07:08 +00:00
Eric Anholt
7a3fb60ac8
docs/ci: Add some links in the CI docs to how to track job flakes
...
and also figuring out how many boards are available for sharding
management.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25806 >
2023-10-23 17:59:55 +00:00
Eric Anholt
553070f993
docs/ci: Drop old instructions for farm disabling
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25806 >
2023-10-23 17:59:55 +00:00
Erik Faye-Lund
ca42706dba
docs: apply some trivial redirects
...
These were found by using the linkcheck builder.
Reviewed-by: Corentin Noël <corentin.noel@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25585 >
2023-10-09 11:54:12 +00:00
Erik Faye-Lund
6f9904923a
docs: update anchor for link
...
GitLab has renamed "specific" runners to "project"-runners. And
additionally, they currently document two ways of creating them.
Let's update the link to point to the new, non-deprecated way.
Reviewed-by: Corentin Noël <corentin.noel@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25585 >
2023-10-09 11:54:11 +00:00
Eric Engestrom
b72f474ff0
docs/ci: rewrite the "farm maintenance ^ other change" rule to mean what we actually meant
...
Sometimes updates to the farm config are needed before re-enabling it,
or updating test expectations with new failures that happened while the
farm was down, etc.
These need to be allowed, as the alternative is to update the
config/expectations/etc. blindly in one MR, merge it, and then merge
another MR with the farm re-enablement.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25560 >
2023-10-06 17:30:04 +00:00
Eric Engestrom
8a80a3607c
docs: document the merging process and what is allowed or not
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/25117 >
2023-09-30 11:42:32 +00:00
Eric Engestrom
7458912333
docs/ci: expand the description of test suites
...
Signed-off-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/24472 >
2023-08-03 19:30:11 +00:00
Eric Engestrom
774ce3ff88
docs/ci: drop mention of build systems variants in the CI
...
We managed to get rid of all the other ones, so let's forget about them
now :P
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/24472 >
2023-08-03 19:30:11 +00:00
Eric Engestrom
a4df4fd0f5
docs/ci: in paragraph about the CI being overwhelmed, mention our tool to help with that
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/24472 >
2023-08-03 19:30:11 +00:00
Eric Engestrom
845518d5d4
docs/ci: stop trying to enumerate drivers that are tested using VK-GL-CTS
...
Most of our drivers are tested by now.
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/24472 >
2023-08-03 19:30:11 +00:00
Helen Koike
0dc961645c
docs/ci: Add docs for EXTRA_LOCAL_PACKAGES
...
Add a section about reusing the CI scripts for other projects.
Signed-off-by: Helen Koike <helen.koike@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/23894 >
2023-07-13 01:06:29 +00:00
Eric Engestrom
f9a4b8e640
docs/ci: fix command to disable/re-enable farms
...
Signed-off-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/23780 >
2023-06-22 07:17:31 +00:00
David Heidelberg
7e56f0389b
ci/docs: fixup incorrect spacing around console block
...
Fixes: dcf5dfbbf8 ("ci: implement farms handling trough files inside .ci-farms")
Signed-off-by: David Heidelberg <david.heidelberg@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/23713 >
2023-06-18 19:29:00 +00:00
David Heidelberg
dcf5dfbbf8
ci: implement farms handling trough files inside .ci-farms
...
- Disable farm with `git mv .ci-farm{,-disabled}/$farm_name`.
- Re-enable farm with `git mv .ci-farm{-disabled,}/$farm_name`.
NEVER MIX FARM MAINTENANCE WITH ANY OTHER CHANGE IN THE SAME MERGE REQUEST!
Reviewed-by: Martin Roukala (né Peres) <martin.roukala@mupuf.org >
Acked-by: Daniel Stone <daniels@collabora.com >
Signed-off-by: David Heidelberg <david.heidelberg@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/23629 >
2023-06-16 22:03:14 +00:00
David Heidelberg
32b150344e
docs: use meson instead invoking ninja directly
...
This approach is available since meson 0.47.0 which we depend on.
Reviewed-by: Sergi Blanch-Torné <sergi.blanch.torne@collabora.com >
Reviewed-by: Erik Faye-Lund <erik.faye-lund@collabora.com >
Signed-off-by: David Heidelberg <david.heidelberg@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/23127 >
2023-05-22 15:41:40 +02:00
Erik Faye-Lund
1aa09f3346
docs: make code-block indents consistent
...
Acked-by: Alyssa Rosenzweig <alyssa.rosenzweig@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22052 >
2023-03-31 09:39:17 +00:00
Erik Faye-Lund
eec6564258
docs: format code-block as toml
...
Acked-by: Alyssa Rosenzweig <alyssa.rosenzweig@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22052 >
2023-03-31 09:39:17 +00:00
Eric Engestrom
8af8c5bd07
ci/docs: start documenting ci_run_n_monitor.py
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/22079 >
2023-03-22 20:48:14 +00:00
Erik Faye-Lund
62b9c32d9d
docs: update link to GitLab CI docs
...
This link is being redirected, but not really where we want to send
people. Let's update it, so they end up in the right place.
Reviewed-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19574 >
2022-11-10 17:26:19 +01:00
Erik Faye-Lund
e5f9a9998d
docs: use anonymous links when possible
...
Anonymous links has some benefits in that it reduces the chance of
warnings when similar identifiers are used. So let's use them instead
when we can.
Reviewed-by: David Heidelberg <david.heidelberg@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19492 >
2022-11-07 10:58:12 +00:00
Erik Faye-Lund
5525d0b196
docs: use inline-code instead of default role
...
A single backtick escaped string in Sphinx refers to the "default role"
which is vague, and in practice ends up producing the HTML cite-element.
That's almost certainly not what these uses wanted.
A bunch of these would probably be better served using appropriate roles
instead of inline-code markup, but this is almost certainly what was
meant here instead. Let's not let perfect be the enemy of good here, and
just do what was intended. Using the right roles everywhere is a big
task.
I usually don't do changes like these to the relnotes, but in this case
there were a *single* article that had these mistakes. I assume that was
an early bug in the script that generateg the relnotes. Let's patch it,
so we don't get misrendering if we change the default-role.
Reviewed-by: Yonggang Luo <luoyonggang@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19494 >
2022-11-04 16:38:06 +00:00
Erik Faye-Lund
a02d3e099e
docs: piglit -> Piglit
...
Reviewed-by: Yonggang Luo <luoyonggang@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19297 >
2022-11-02 10:16:44 +00:00
Erik Faye-Lund
4622c357db
docs: panfrost -> Panfrost
...
Reviewed-by: Yonggang Luo <luoyonggang@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19297 >
2022-11-02 10:16:44 +00:00
Erik Faye-Lund
ac031f66c3
docs: softpipe -> Softpipe
...
Reviewed-by: Yonggang Luo <luoyonggang@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19297 >
2022-11-02 10:16:44 +00:00
Erik Faye-Lund
99b45b2b68
docs: llvmpipe -> LLVMpipe
...
Reviewed-by: Yonggang Luo <luoyonggang@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19297 >
2022-11-02 10:16:44 +00:00
Erik Faye-Lund
f90f194cff
docs: freedreno -> Freedreno
...
Reviewed-by: Yonggang Luo <luoyonggang@gmail.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19297 >
2022-11-02 10:16:44 +00:00
Erik Faye-Lund
9d64954bcb
docs: Gitlab -> GitLab
...
While we're at it, also fixup a single case of "Ci" -> "CI"
Reviewed-by: David Heidelberg <david.heidelberg@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19191 >
2022-10-25 10:06:45 +00:00
Erik Faye-Lund
7041cf6612
docs: use consistent casing for dEQP
...
Reviewed-by: David Heidelberg <david.heidelberg@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19191 >
2022-10-25 10:06:45 +00:00
Erik Faye-Lund
4453948a5f
docs: consistently spell URL in allcaps
...
Reviewed-by: David Heidelberg <david.heidelberg@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/19191 >
2022-10-25 10:06:45 +00:00
David Heidelberg
3ea0ec4697
docs/ci: show how to run traces locally
...
Newcomers may want to test traces locally and understand how the replay
works.
Acked-by: Guilherme Gallo <guilherme.gallo@collabora.com >
Signed-off-by: David Heidelberg <david.heidelberg@collabora.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/17347 >
2022-08-09 13:59:59 +02:00
Eric Engestrom
d5dec00e94
docs/ci: fix Emma's name
...
Signed-off-by: Eric Engestrom <eric@igalia.com >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/17795 >
2022-07-28 17:12:37 +00:00
Guilherme Gallo
9314950726
ci: Add docs for Linux Kernel uprevs
...
Signed-off-by: Guilherme Gallo <guilherme.gallo@collabora.com >
Reviewed-by: Emma Anholt <emma@anholt.net >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/14514 >
2022-01-20 01:29:45 +00:00
Guilherme Gallo
9f58275f98
ci: skqp: Add documentation on how to maintain skqp jobs
...
Signed-off-by: Guilherme Gallo <guilherme.gallo@collabora.com >
Reviewed-by: Emma Anholt <emma@anholt.net >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/14146 >
2022-01-05 20:15:04 +00:00
Antonio Caggiano
92f9141f00
ci/freedreno: Test with non-redistributable traces
...
Add a job to test with traces that we cannot redistribute, listed in a
separate file. Since those traces might not be accessible by everyone,
this job is created only when the pipeline is triggered by `marge-bot`.
This job is optional because otherwise it could be blocking a merge
request of someone who cannot really debug the issue due to lack of
access to these traces.
The documentation available under `docs/ci` goes into more details
explaining the rationale behind optional traces.
Signed-off-by: Antonio Caggiano <antonio.caggiano@collabora.com >
Signed-off-by: Tomeu Vizoso <tomeu.vizoso@collabora.com >
Reviewed-by: Emma Anholt <emma@anholt.net >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/6441 >
2021-07-28 13:49:11 +00:00
Erik Faye-Lund
c289e88809
docs: drop clayton from intel-ci notice
...
As per his request.
Reviewed-by: Clayton Craft <clayton@craftyguy.net >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10975 >
2021-05-27 10:08:13 +00:00
Erik Faye-Lund
e710b9bd7b
docs: update another IRC reference
...
In the last round of IRC link updates, #freedesktop hadn't moved yet. Now
it has, so let's update the reference.
Reviewed-by: Adam Jackson <ajax@redhat.com >
Reviewed-by: Daniel Stone <daniels@collabora.com >
Reviewed-by: Clayton Craft <clayton@craftyguy.net >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10975 >
2021-05-27 10:08:13 +00:00
Erik Faye-Lund
bc1240ce94
docs: update another IRC reference
...
I didn't initially update this one because craftguy hadn't moved to OFTC
when I wrote the last patch. But now he has, so let's also update this
reference.
Reviewed-by: Adam Jackson <ajax@redhat.com >
Reviewed-by: Daniel Stone <daniels@collabora.com >
Reviewed-by: Clayton Craft <clayton@craftyguy.net >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10975 >
2021-05-27 10:08:13 +00:00
Jordan Justen
57897b4095
docs: Rename master branch to main
...
Signed-off-by: Jordan Justen <jordan.l.justen@intel.com >
Reviewed-by: Eric Engestrom <eric@engestrom.ch >
2021-05-05 12:21:00 -07:00
Jose Fonseca
6e6cd7d93c
scons: Remove.
...
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/9720 >
2021-03-20 10:38:55 +00:00
Eric Anholt
04a2f1462e
ci/docs: Update CI farm requirements suggestions.
...
We have a handy printout for slow tests now, and DEQP_FRACTION is now
compatible with parallel.
Reviewed-by: Daniel Stone <daniel@fooishbar.org >
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/8727 >
2021-02-01 18:32:01 +00:00