Skip to content

[docs] Update glossary - weekly full scan#19192

Merged
pelikhan merged 2 commits intomainfrom
docs/glossary-weekly-scan-2026-03-02-43a840b339f41252
Mar 2, 2026
Merged

[docs] Update glossary - weekly full scan#19192
pelikhan merged 2 commits intomainfrom
docs/glossary-weekly-scan-2026-03-02-43a840b339f41252

Conversation

@github-actions
Copy link
Contributor

@github-actions github-actions bot commented Mar 2, 2026

Glossary Updates - 2026-03-02

Scan Type

  • Incremental (daily - last 24 hours)
  • Full scan (weekly - last 7 days)

Terms Added

  • Custom Safe Outputs: The jobs: mechanism under safe-outputs for third-party integrations was added via custom-safe-outputs.md reference doc but had no glossary entry.
  • Assign to Agent: The assign-to-agent: safe output for programmatically assigning the Copilot coding agent was documented in assign-to-copilot.mdx but missing from the glossary.
  • Stop After: The stop-after: workflow field for time-based auto-stop was documented in ephemerals.md but missing from the glossary.
  • Ephemerals: The category concept for auto-expiring resources was documented in guides/ephemerals.md but had no glossary entry.

Terms Updated

None.

Changes Analyzed

Related Changes

Notes

The required_state field added to gh aw checks --json (PR #19161) is an internal CLI output field, not user-facing configuration, so it was not added to the glossary. The safe-output-custom-tokens rename (PR #19156) is an internal implementation detail — not user-visible configuration — so it also did not warrant a glossary entry.

Generated by Glossary Maintainer

  • expires on Mar 4, 2026, 10:22 AM UTC

… Ephemerals

Weekly full scan (2026-03-02) identified four new user-facing terms introduced
in recent changes:

- Custom Safe Outputs: jobs: section for third-party integrations
- Assign to Agent: assign-to-agent: safe output for Copilot coding agent
- Stop After: stop-after: workflow time-limit field
- Ephemerals: category for auto-expiring workflow resources

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions bot added documentation Improvements or additions to documentation glossary labels Mar 2, 2026
@pelikhan pelikhan marked this pull request as ready for review March 2, 2026 12:18
Copilot AI review requested due to automatic review settings March 2, 2026 12:18
@pelikhan pelikhan merged commit 71de9c3 into main Mar 2, 2026
2 checks passed
@pelikhan pelikhan deleted the docs/glossary-weekly-scan-2026-03-02-43a840b339f41252 branch March 2, 2026 12:18
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

Updates the documentation glossary to add missing entries discovered in the weekly full scan (2026-03-02), covering newly documented workflow/safe-output concepts.

Changes:

  • Added glossary entries for Assign to Agent and Custom Safe Outputs
  • Added glossary entry for Stop After (stop-after:) workflow trigger deadline behavior
  • Added glossary entry for Ephemerals as the umbrella concept for expiration/noise-reduction features

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


### Stop After

A workflow configuration field (`stop-after:`) that automatically prevents new runs after a specified time limit. Accepts absolute dates (`YYYY-MM-DD`, ISO 8601) or relative time deltas (`+48h`, `+7d`). Minimum granularity is hours. Useful for trial periods, experimental features, and cost-controlled schedules. Recompile with `gh aw compile --refresh-stop-time` to reset the deadline. See [Ephemerals](/gh-aw/guides/ephemerals/).
Copy link

Copilot AI Mar 2, 2026

Choose a reason for hiding this comment

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

The Stop After entry understates the accepted absolute date formats. The Triggers reference documents additional supported absolute formats (e.g., MM/DD/YYYY, DD/MM/YYYY, January 2 2006, 1st June 2025) beyond YYYY-MM-DD/ISO 8601; consider wording this as “supports multiple absolute date formats (including …)” to avoid implying only those two formats are valid. Also consider clarifying that stop-after: is configured under the on: trigger section (see docs/src/content/docs/reference/frontmatter.md:27-39).

Suggested change
A workflow configuration field (`stop-after:`) that automatically prevents new runs after a specified time limit. Accepts absolute dates (`YYYY-MM-DD`, ISO 8601) or relative time deltas (`+48h`, `+7d`). Minimum granularity is hours. Useful for trial periods, experimental features, and cost-controlled schedules. Recompile with `gh aw compile --refresh-stop-time` to reset the deadline. See [Ephemerals](/gh-aw/guides/ephemerals/).
A workflow trigger configuration field (`stop-after:` under the `on:` section) that automatically prevents new runs after a specified time limit. Supports multiple absolute date formats (including `YYYY-MM-DD`, ISO 8601, `MM/DD/YYYY`, `DD/MM/YYYY`, `January 2 2006`, `1st June 2025`) as well as relative time deltas (`+48h`, `+7d`). Minimum granularity is hours. Useful for trial periods, experimental features, and cost-controlled schedules. Recompile with `gh aw compile --refresh-stop-time` to reset the deadline. See [Ephemerals](/gh-aw/guides/ephemerals/).

Copilot uses AI. Check for mistakes.

### Ephemerals

A category of features for automatically expiring workflow resources to reduce repository noise and control costs. Includes workflow stop-after scheduling, safe output expiration (auto-closing issues, discussions, and pull requests), and hidden older status comments. See [Ephemerals](/gh-aw/guides/ephemerals/).
Copy link

Copilot AI Mar 2, 2026

Choose a reason for hiding this comment

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

The Ephemerals definition says it includes “hidden older status comments”, but the guide/reference feature is hide-older-comments (general comment minimization) and it isn’t limited to “status” comments. Suggest rephrasing to “hiding older comments” / “minimizing older workflow comments” to match the documented feature name and scope (see docs/src/content/docs/guides/ephemerals.md:102-117).

Suggested change
A category of features for automatically expiring workflow resources to reduce repository noise and control costs. Includes workflow stop-after scheduling, safe output expiration (auto-closing issues, discussions, and pull requests), and hidden older status comments. See [Ephemerals](/gh-aw/guides/ephemerals/).
A category of features for automatically expiring workflow resources to reduce repository noise and control costs. Includes workflow stop-after scheduling, safe output expiration (auto-closing issues, discussions, and pull requests), and minimizing older workflow comments. See [Ephemerals](/gh-aw/guides/ephemerals/).

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation glossary

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants