Skip to content

docs: fix misleading require-approval timeout-minutes comment in create prompt#1475

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-require-approval-timeout-comment-710daa011225a7cc
Draft

docs: fix misleading require-approval timeout-minutes comment in create prompt#1475
github-actions[bot] wants to merge 1 commit into
mainfrom
docs/fix-require-approval-timeout-comment-710daa011225a7cc

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Agent Documentation Update

Findings

Area Issue File(s)
accuracy timeout-minutes: 1440 # Optional: 24h default implies 1440 minutes (24h) is the default value, but the field actually defaults to None (inheriting the pipeline/job timeout). This could cause agents using the prompt to believe they're relying on a 24h default when they omit the field. prompts/create-ado-agentic-workflow.md

Applied Fixes

  • Corrected the timeout-minutes comment in the require-approval example from # Optional: 24h default to # Optional: e.g. 1440 for 24h; omit → pipeline/job timeout applies — consistent with docs/safe-outputs.md which already says omit → pipeline default.

Notes

Verified against src/compile/types.rs ApprovalConfig.timeout_minutes:

/// Pending-period timeout in minutes. None → ADO job/stage timeout applies.
#[serde(default)]
pub timeout_minutes: Option<u32>,

The field defaults to None. The docs/safe-outputs.md reference page at line 67 correctly documents this as omit → pipeline default, so this PR brings the create prompt into alignment.


Created by the agent-documentation maintainer workflow.

Generated by Agent Documentation Maintainer · 281 AIC · ⌖ 11.6 AIC · ⊞ 8.4K ·

…te prompt

The comment 'Optional: 24h default' implied that 1440 minutes was the
default value for timeout-minutes, when in fact the field defaults to
None (inheriting the pipeline/job timeout). Updated to clarify that
1440 is an example value and that omitting the field uses the pipeline
default — consistent with docs/safe-outputs.md which already says
'omit → pipeline default'.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.

0 participants