Skip to content

docs: document trigger shorthands#18764

Merged
pelikhan merged 4 commits intomainfrom
eaftan/document-special-triggers
Feb 28, 2026
Merged

docs: document trigger shorthands#18764
pelikhan merged 4 commits intomainfrom
eaftan/document-special-triggers

Conversation

@eaftan
Copy link
Contributor

@eaftan eaftan commented Feb 27, 2026

Add documentation for all natural-language trigger shorthands supported by ParseTriggerShorthand. A user in our Slack channel asked about one of these, and pointed out that they are not documented.

The on: field accepts shorthand strings like push to main, pull_request merged, issue opened, release published, etc. that the compiler expands into standard GitHub Actions trigger syntax. These were previously undocumented (only label shorthands like issue labeled bug were documented).

Changes:

  • Added a "Trigger Shorthands" section to docs/src/content/docs/reference/triggers.md
  • Covers source control, issue, discussion, manual, comment, release, repository, security, and external integration shorthands
  • Cross-references the existing Label Filtering section to avoid duplication

eaftan and others added 3 commits February 27, 2026 15:27
Add comprehensive documentation for all natural-language trigger
shorthands supported by ParseTriggerShorthand, including:
- Source control: push to/tags, pull_request types/merged/affecting
- Issue and discussion activity type shorthands
- Manual, comment, release, repository shorthands
- Security (dependabot, code scanning) shorthands
- External integration (api dispatch) shorthands
- Complete reference table with expansion details

The label trigger shorthands were already documented; all other
trigger shorthands were previously undocumented.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Consolidate 8 subsections into 3, remove redundant reference table,
and cross-reference the existing Label Filtering section instead of
duplicating label shorthand docs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@eaftan eaftan requested review from Copilot and pelikhan February 27, 2026 23:35
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds missing documentation for the natural-language trigger shorthand strings accepted by the on: field and expanded by the compiler into GitHub Actions trigger syntax.

Changes:

  • Added a new Trigger Shorthands reference section for on: string forms (e.g., push to main, pull_request merged, issue opened, etc.).
  • Documented supported shorthand categories (source control, issues/discussions, manual/workflow chaining, comments, releases, repository lifecycle, security, external integration).
  • Linked to the existing Label Filtering section to avoid duplicating label-shorthand docs.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@pelikhan pelikhan merged commit 3ea6ab0 into main Feb 28, 2026
2 checks passed
@pelikhan pelikhan deleted the eaftan/document-special-triggers branch February 28, 2026 01:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants