docs: add [skip ci] documentation to CONTRIBUTING.md

[garciadias]

Description

Adds a new "Skipping CI" section to CONTRIBUTING.md documenting the native GitHub Actions commit-message mechanism for skipping CI pipelines.

The section covers:

• Supported keywords ([skip ci], [ci skip], [no ci], [skip actions], [actions skip])
• The skip-checks: true trailer alternative
• Which workflows are affected vs unaffected by the skip instruction
• The caveat about required checks remaining in "Pending" state
• Guidance on when to (and not to) use [skip ci]

No workflow YAML changes needed — GitHub Actions handles this natively.

Types of changes

• Non-breaking change (fix or new feature that would not break existing functionality).
• Breaking change (fix or new feature that would cause existing functionality to change).
• New tests added to cover the changes.
• Integration tests passed locally by running ./runtests.sh -f -u --net --coverage.
• Quick tests passed locally by running ./runtests.sh --quick --unittests --disttests.
• In-line docstrings updated.
• Documentation updated, tested make html command in the docs/ folder.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 23b0e660-0264-44fb-ad97-684a33c68b42

📥 Commits

Reviewing files that changed from the base of the PR and between f817537 and 975b373.

📒 Files selected for processing (1)

• CONTRIBUTING.md

🚧 Files skipped from review as they are similar to previous changes (1)

• CONTRIBUTING.md

---

📝 Walkthrough

Walkthrough

Added new "Skipping CI" documentation section to CONTRIBUTING.md describing commit-message keywords ([skip ci], etc.) and skip-checks: true trailer format for skipping GitHub Actions workflows on push and pull_request events, including affected workflow groups, pending checks caveat, usage guidance, and example command.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: adding [skip ci] documentation to CONTRIBUTING.md, which aligns with the PR objectives.
Description check	✅ Passed	The description covers all required template sections with substantive detail, including a clear description of changes, accurate types of changes checkboxes, and notes about documentation testing.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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.}

[coderabbitai]

Actionable comments posted: 1

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)

CONTRIBUTING.md (1)

1-16: ⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

Add Skipping CI to the TOC.

The new section at Line 361 is not linked in the top TOC, so document navigation is incomplete.

Also applies to: 361-361

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CONTRIBUTING.md` around lines 1 - 16, The table of contents is missing an
entry for the new "Skipping CI" section introduced at line 361; update the TOC
in CONTRIBUTING.md by adding a "Skipping CI" link (with the correct markdown
anchor `#skipping-ci`) under the appropriate subsection (likely under "Preparing
pull requests" or where other PR workflow items live) so the new section is
reachable from the top navigation; ensure the link text exactly matches the
section heading "Skipping CI" and follows the numbering/indent style used for
neighboring TOC entries.

🧹 Nitpick comments (1)

CONTRIBUTING.md (1)

411-429: ⚡ Quick win

Avoid a brittle hardcoded workflow inventory.

This explicit list will drift as workflows evolve. Consider reframing as examples and linking to .github/workflows/ to keep this section current.

As per coding guidelines, "**/*.md: Remember that documentation must be updated with the latest information."

🤖 Prompt for AI Agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CONTRIBUTING.md` around lines 411 - 429, The explicit inventory of workflows
(e.g., premerge, premerge-min, premerge-gpu, CodeQL analysis, Docker build,
Blossom-CI, ChatOps, Integration tests, Cron jobs, Weekly preview, Conda build)
is brittle and will drift; update the CONTRIBUTING.md text to present these as
representative examples rather than a definitive list, remove the hardcoded
enumeration, and add a short sentence pointing readers to the repository's
workflows directory (so maintainers can see current workflow names) along with
guidance to update the docs whenever workflows change.

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CONTRIBUTING.md`:
- Around line 389-393: Update the fenced code block that currently shows the
example commit message containing "commit message" and "skip-checks: true" to
include a language specifier (e.g., add "text" or "md" after the opening `````),
so the block becomes `````text` (or `````md`) to satisfy MD040 and keep the
markdown lint-clean; locate the fenced block in CONTRIBUTING.md that contains
the literal "commit message" and modify its opening fence accordingly.

---

Outside diff comments:
In `@CONTRIBUTING.md`:
- Around line 1-16: The table of contents is missing an entry for the new
"Skipping CI" section introduced at line 361; update the TOC in CONTRIBUTING.md
by adding a "Skipping CI" link (with the correct markdown anchor `#skipping-ci`)
under the appropriate subsection (likely under "Preparing pull requests" or
where other PR workflow items live) so the new section is reachable from the top
navigation; ensure the link text exactly matches the section heading "Skipping
CI" and follows the numbering/indent style used for neighboring TOC entries.

---

Nitpick comments:
In `@CONTRIBUTING.md`:
- Around line 411-429: The explicit inventory of workflows (e.g., premerge,
premerge-min, premerge-gpu, CodeQL analysis, Docker build, Blossom-CI, ChatOps,
Integration tests, Cron jobs, Weekly preview, Conda build) is brittle and will
drift; update the CONTRIBUTING.md text to present these as representative
examples rather than a definitive list, remove the hardcoded enumeration, and
add a short sentence pointing readers to the repository's workflows directory
(so maintainers can see current workflow names) along with guidance to update
the docs whenever workflows change.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 13507825-e844-4464-9e6e-440790e94a71

📥 Commits

Reviewing files that changed from the base of the PR and between e33941c and f817537.

📒 Files selected for processing (1)

• CONTRIBUTING.md