mesa/docs/gitlab-ci.yml
Eric Engestrom 2e33098162
Some checks are pending
macOS-CI / macOS-CI (dri) (push) Waiting to run
macOS-CI / macOS-CI (xlib) (push) Waiting to run
docs/ci: always build the docs
It only takes 2 min of runner time, and it's been broken several times
by now, so let's just always run this job.

Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/36893>
2025-08-26 09:49:56 +00:00

57 lines
1.6 KiB
YAML

include:
- local: 'docs/gitlab-ci-inc.yml'
deploy-docs:
extends: .docs-base
stage: deploy
pages: true
rules:
- !reference [.common-rules, rules]
- !reference [.no_scheduled_pipelines-rules, rules]
# post-merge pipeline
- if: '$CI_PROJECT_NAMESPACE == "mesa" && $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH && $CI_COMMIT_BRANCH'
changes: &docs-or-ci
- docs/**/*
- .gitlab-ci.yml
- src/util/format/**/*
# All the following source files documentation is extracted from
# git grep -h ":file: src/" -- docs | sort | uniq
- src/compiler/nir/nir.h
- src/intel/isl/**/*
- src/vulkan/runtime/**/*
when: always
test-docs:
extends: .docs-base
# Cancel job if a newer commit is pushed to the same branch
interruptible: true
stage: deploy
rules:
- !reference [.common-rules, rules]
# merge pipeline
- if: '$CI_PIPELINE_SOURCE == "merge_request_event" && $GITLAB_USER_LOGIN == "marge-bot"'
when: on_success
# pre-merge pipeline
- if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
when: manual
linkcheck-docs:
extends: .docs-base
# Cancel job if a newer commit is pushed to the same branch
interruptible: true
stage: deploy
rules:
- !reference [.common-rules, rules]
- !reference [.scheduled_pipeline-rules, rules]
# pre-merge pipeline
- if: '$CI_PIPELINE_SOURCE == "merge_request_event" && $GITLAB_USER_LOGIN != "marge-bot"'
when: manual
allow_failure: true
script:
- |
if ! sphinx-build -W -b linkcheck docs public
then
echo "Summary:"
cat public/output.txt
exit 1
fi