Skip to content

docs: expand sanitized outputs documentation and add deprecation notes for needs.activation.outputs.text/title/body#44932

Closed
pelikhan with Copilot wants to merge 3 commits into
mainfrom
copilot/hippo-migrate-workflow-examples
Closed

docs: expand sanitized outputs documentation and add deprecation notes for needs.activation.outputs.text/title/body#44932
pelikhan with Copilot wants to merge 3 commits into
mainfrom
copilot/hippo-migrate-workflow-examples

Conversation

Copilot AI commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

Hippo repeatedly recalled deprecation guidance for needs.activation.outputs.{text,title,body}. No workflow .md files or docs actually used the deprecated form — all were already correct — but the reference docs only mentioned steps.sanitized.outputs.text, leaving title and body undocumented and the deprecation of the old form unmentioned.

Changes

  • .github/aw/context.md: Expanded the sanitized outputs section to document all three outputs (text, title, body) with a per-event behavior table and an explicit deprecation blockquote clarifying that only these three are affected — other needs.activation.outputs.* fields (comment_id, slash_command, etc.) remain valid in downstream jobs.

  • .github/aw/github-agentic-workflows.md and .github/aw/workflow-constraints.md: Updated the one-liner security rule to enumerate all three variants and explicitly warn against the deprecated aliases.

  • docs/src/content/docs/reference/templating.md: Added a :::note[Deprecated form] callout after the sanitized outputs list.

Before (context.md):

- Use `${{ steps.sanitized.outputs.text }}` for untrusted user content.

After:

- Use `${{ steps.sanitized.outputs.text }}` (full context), `${{ steps.sanitized.outputs.title }}` (title only),
  or `${{ steps.sanitized.outputs.body }}` (body only) for untrusted user content.
  Do not use the deprecated `needs.activation.outputs.text/title/body` aliases.

Copilot AI and others added 2 commits July 11, 2026 10:51
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Migrate workflow markdown examples to steps.sanitized.outputs docs: expand sanitized outputs documentation and add deprecation notes for needs.activation.outputs.text/title/body Jul 11, 2026
Copilot AI requested a review from pelikhan July 11, 2026 11:00
@pelikhan pelikhan closed this Jul 11, 2026
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.

[hippo] Migrate workflow markdown examples to steps.sanitized.outputs.*

2 participants