Merge remote-tracking branch 'upstream/main' into root #28

	name: XTasks

	on:
	pull_request:
	paths:
	- "xtask"
	- "Cargo.toml"
	- "Cargo.lock"
	- ".cargo"
	- "core/tabs"
	- "docs"
	push:
	paths:
	- "xtask"
	- "Cargo.toml"
	- "Cargo.lock"
	- ".cargo"
	- "core/tabs"
	- "docs"

	env:
	CARGO_TERM_COLOR: always

	jobs:
	docgen:
	name: DocGen
	runs-on: ubuntu-latest

	steps:
	- name: Checkout sources
	uses: actions/checkout@v4

	- name: Install Rust
	uses: dtolnay/rust-toolchain@stable

	- name: Cache Cargo registry
	uses: actions/cache@v4
	with:
	path: ~/.cargo/registry
	key: ${{ runner.os }}-cargo-registry-${{ hashFiles('**/Cargo.lock') }}
	restore-keys: ${{ runner.os }}-cargo-registry-

	- name: Cache Cargo index
	uses: actions/cache@v4
	with:
	path: ~/.cargo/git
	key: ${{ runner.os }}-cargo-index-${{ hashFiles('**/Cargo.lock') }}
	restore-keys: ${{ runner.os }}-cargo-index-

	- name: Run cargo xtask docgen
	run: cargo xtask docgen

	- name: Check uncommitted documentation changes
	run: \|
	git diff
	git diff-files --quiet \
	\|\| (echo "Run 'cargo xtask docgen' and push the changes" \
	&& exit 1)

Provide feedback