⬆️ Update prek checks

[denialhaag]

Description

This PR updates .pre-commit-config.yml to make use of prek's priority feature.

Checklist:

• The pull request only contains commits that are focused and relevant to this change.
• I have added appropriate tests that cover the new/changed functionality.
• I have updated the documentation to reflect these changes.
• The changes follow the project's style guidelines and introduce no new warnings.
• The changes are fully tested and pass the CI checks.
• I have reviewed my own code changes.

[coderabbitai]

📝 Walkthrough

Summary by CodeRabbit

• Chores

  • Updated CI workflow runners.
  • Reorganized pre-commit configuration into prioritized execution stages (fast checks, formatters, final checks).
  • Added/adjusted checks and formatters (capitalization check, license header check, spelling tool update, formatter and linter stages).

• Documentation

  • Restructured Developers section navigation in documentation.

Walkthrough

GitHub Actions runners in two workflows are changed from ubuntu-latest to ubuntu-slim; pre-commit configuration is reorganized into priority-grouped hooks with additions/removals and version tweaks; docs/index.md toctree entries for the Developers section are restructured into hidden HTML toctree blocks.

Changes

Cohort / File(s)	Summary
GitHub Actions Workflows .github/workflows/release-drafter.yml, .github/workflows/templating.yml	Updated runs-on from ubuntu-latest to ubuntu-slim for the respective jobs (update_release_draft, render-template) with no other step changes.
Pre-commit Configuration .pre-commit-config.yaml	Major rework introducing priority-grouped hooks (Priority 0/1/2+), added hooks (e.g., check-jsonschema, local disallow-caps, license-tools, bibtex-tidy), adjusted versions/priorities (typos, ruff/black configs), and removed several legacy hooks.
Documentation Structure docs/index.md	Reorganized Developers section to use hidden HTML-only toctree blocks, moving overview, stats, and support items into the new structure.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• 👷 Use new ubuntu-slim runners for light workflows workflows#292: Changes the same workflow files (release-drafter.yml, templating.yml) switching runners to ubuntu-slim.
• ⬆️ Update runners and prek checks predictor#582: Mirrors the same runner swaps and the extensive .pre-commit-config.yaml rework found here.
• ⬆️ Update prek checks core-plugins-catalyst#55: Similar edits to workflow runners and the priority-based restructure of .pre-commit-config.yaml.

Poem

🐇 I hopped through CI with a twitchy grin,
swapped runners light and trimmed the bin,
hooks in tiers, lined up in rows,
docs tucked neatly where no one goes —
a tiny rabbit cheered: "Now watch it spin!"

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title refers to updating 'prek' checks, which directly aligns with the main change of updating .pre-commit-config.yml to use prek's priority feature.
Description check	✅ Passed	The description clearly states the main purpose (updating .pre-commit-config.yml for prek's priority feature) and includes a completed checklist, though test and documentation updates are marked as not applicable.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch prek

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[burgholzer]

Also LGTM.
I guess adding ty etc. here does not really make too much sense.