Repository navigation
[docs] Update documentation for features from 2026-11-17 - #78719
Merged
github-actions[bot] merged 1 commit intoNov 17, 2026
Merged
github-actions[bot] merged 1 commit into
github-actions[bot] merged 1 commit into
Conversation
Contributor
There was a problem hiding this comment.
🟢 Approval recommended
No active review issues remain, and the artifact reference has been updated to reflect current command behavior, corrected mappings, defaults, and OTLP metrics.
No open issues 🎉
What changed in this PR
Updates the artifact reference to match current gh aw logs and gh aw audit behavior, including delivery reporting, corrected artifact mappings, download defaults, and OTLP metrics.
Changes:
- Replaces the removed
outcomesselector withdeliveryand adds migration guidance. - Corrects artifact-set mappings and documents the
infoset and command defaults. - Documents
otel-metrics.jsonl, its enablement conditions, and agent-job coverage.
| File | Description |
|---|---|
| docs/src/content/docs/reference/artifacts.md | Updates artifact-set mappings, delivery/adoption guidance, command defaults, and OTLP metrics documentation. |
Review effort: Lite (adaptive)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documentation Updates - 2026-11-17
Updates the Artifacts reference for delivery/adoption reporting (#78658) and OTLP metrics (#78433). The artifact-set table still advertised the removed
outcomesselector and omitted the metrics mirror.One page changed: 10 insertions, 6 deletions; all 14 current artifact sets are listed.
Features Documented
outcomeswithdelivery, including itsusageartifact and migration guidance without a compatibility alias. Link to the existing delivery/adoption reference.otel-metrics.jsonl, its OTLP/runtime enablement conditions, and its agent-job coverage boundary.logs/auditdownload defaults, addinfo, and reconcile agent, firewall, and MCP set mappings with the current CLI.Detailed changes and references
Changes Made
Only
docs/src/content/docs/reference/artifacts.mdchanged. Mappings were checked againstpkg/cli/logs_artifact_set.go; defaults against the logs and audit commands; metrics upload conditions againstpkg/workflow/compiler_yaml_post_agent.goand the OpenTelemetry Metrics reference.Merged PRs Referenced
Other reviewed user-facing changes already have reference coverage, including repository-configured issue labels, direct-provider network opt-ins, JavaScript-only operational-value graders, and unsupported GitHub MCP access controls. Internal refactors, dependency pins, and presentation/site changes did not justify additional reference edits.
Validation
git diff --check, artifact-table structure, and new documentation link/anchor checks.make agent-report-progresspassed its initial stale-workflow, instruction-prefix, formatting, local-settings, and whitespace checks, then stopped atgo build: downloading Go 1.27.4 failed TLS certificate validation. Unit tests did not run. Certificate verification was left unchanged. This limitation was recorded withreport_incomplete.Skipped Issues
Existing coverage and remaining work
reference/compliance-patterns.md.gh awprefix in CLI errors and help #78463. The reviewed gaps in [cli-consistency] CLI Consistency Issues - 2026-11-13 #77456, docs: lead model-choice guidance with default routing and model: router #76983, Update thetoken-steeringandmax-ai-creditsdocs for AWF's on-by-default budget notices #77053, [cli-consistency] CLI Consistency Issues - 2026-11-11 #76872, [cli-consistency] CLI Consistency Issues - 2026-11-10 #76525, [cli-consistency] CLI Consistency Issues - 2026-10-29 #72983, and [cli-consistency] CLI Consistency Issues - 2026-10-28 #72701 already have relevant current reference coverage.Some issue/PR search results and PR file details were filtered by the configured integrity policy. Those unavailable records were not inspected through alternate paths, so the activity review is limited to exposed data.
Notes
The requested
.github/instructions/documentation.instructions.mddoes not exist in this checkout; the repository documentation skill supplied the style guidance. Steering issue #78717 had no comments on both checks.AI dictionary alignment summary: no generic AI-coding terms were introduced or revised; only repository artifact selectors and OTLP terminology changed. Terms adopted: none. Conflicts resolved: none.
Next Actions
Review the documentation-only diff and complete repository validation in an environment that can obtain the required Go toolchain before marking the draft ready.