Audit factories and cloud-agent docs against current product behavior #1034

Description

Sweep factories and cloud-agent documentation for omitted capabilities, operational details, and incorrect instructions against current product behavior.
Correct the verified candidates below and separate independent fixes into focused PRs.
Reuse existing work rather than duplicating it; this request does not waive specification or review.

Reproduction

Source comparison identifies the causes; no UI reproduction is needed for these textual contradictions.
The coverage/change audit scanned 418 pages, ran all 10 checks with none skipped, and accounted for every extracted surface; its 164 raw signals are not 164 actionable fixes.

Acceptance criteria

• Reconcile Jira keyword/session instructions and Azure DevOps trigger authoring with the canonical trigger reference; test matching, nonmatching, overlapping, and continuation cases.
• Correct orchestrated-child idle-timeout guidance and check related handoff/session instructions against the effective defaults and overrides.
• Update definition-hosting guidance for supported code forges, including prerequisites and permissions, without changing page purposes.
• Correct MCP/Secrets navigation and evaluate browser-notification instructions against the released interface, with visual evidence for changed UI procedures.
• Disposition remaining scoped audit signals as covered, correction, missing detail, existing work, or deferred; verify availability before drafting and validate each focused PR.

Proposed solution direction

Prefer corrections to the pages that own each workflow and keep related references consistent.
Refresh or extend the overlapping PRs below where practical instead of opening competing changes to the same files.
Do not publish source-only or rollout-blocked capabilities as available features.

References

• Docs baseline: ca3bf9c; public client baseline: 829f395. Research date: 2026-11-13. Complexity: L. Ambiguity: none. No requester decision blocks triage.
• Jira contradiction: integration procedure promises keyword filtering, while the trigger reference says session keywords do not restrict matching. Align examples and troubleshooting too.
• Azure DevOps contradiction: integration procedure permits authored push and source_repos, while the trigger reference disallows authored push and calls source_repos server-managed.
• Idle timeout: definition syntax still states a 60-minute orchestrated-child default. Recheck the separate parent wait window rather than treating it as a child retention guarantee.
• Definition hosting: syntax lists only Warp-managed and GitHub; GitLab explicitly denies GitLab definition hosting. Recheck supported forge linking and plan/access conditions.
• Navigation owners: dashboard, MCP, secrets, and their task-specific descendants. Current instructions point to top-level sidebar resources.
• Related tracking: Audit Factory help destinations and clarify supported standalone trigger docs #1019 / docs: clarify factory setup and retain standalone trigger workflows #1020 (setup, triggers, help destinations); Audit factory positioning and align writing guidance with infrastructure framing #1010 / docs: preserve workflow framing review guidance #1031 (positioning and writing guidance).
• Existing factory sweep: docs: match factory agents and skills pages to the seeded defaults (audit 1/5) #853 (agents/skills), docs: polish the measurement and dashboard pages (audit 2/5) #854 (metrics/dashboard/benchmarks), docs: polish the factory integration and intake pages (audit 3/5) #855 (integrations/intake), docs: polish the factory developer tool pages (audit 4/5) #856 (developer tools), docs: polish the factory infrastructure and self-hosting pages (audit 5/5) #857 (infrastructure). These share some overview files and need coordination, not parallel duplication.
• Other overlapping work: docs: explain periodic workspace snapshots #945 (periodic snapshots), docs: document per-dispatch settings for factory agents #980 (per-dispatch configuration), [ACP] Document the ACP sidecar images and terminal fallback for self-hosted workers #983 (ACP), docs: list attach_integration, start_factory_learning and list_inbox in the Factory MCP tool reference #1029 (MCP tools), Add the Metrics API guide #819 (Metrics API), docs: private image credentials (docker-registry secrets) #767 (private registry), docs: clarify GitHub repo access patterns for cloud agents (flexible environments) #390 (repository access), docs: align API, CLI, and Session Sharing claims #840 (API/CLI/session claims), docs: align billing and entitlement claims #833/docs: align privacy and security claims #836 (billing/security), chore: docs consistency audit state #876 (consistency state).
• Exclusions: no product redesign, page retirement, policy invention, private endpoint publication, or blanket rename. Keep rollout-unconfirmed candidates deferred and existing policy-owner blockers unresolved. Do not reset the audit snapshot or resolve saved findings from this scoped triage.

Responding as Docs Factory (V2)