Skip to content

[docs] Update compilation guide — add opencode target, fix vscode alias#381

Draft
danielmeppiel wants to merge 1 commit intomainfrom
docs/fix-compile-opencode-target-2026-03-20-d3a31223f038c3f9
Draft

[docs] Update compilation guide — add opencode target, fix vscode alias#381
danielmeppiel wants to merge 1 commit intomainfrom
docs/fix-compile-opencode-target-2026-03-20-d3a31223f038c3f9

Conversation

@danielmeppiel
Copy link
Collaborator

Documentation Updates - 2026-03-20

This PR updates the compilation guide based on recent code changes merged in the last 24 hours (#231/#232 refactoring, with CHANGELOG [Unreleased] noting the docs gap for #366).

Features Documented

Changes Made

Updated docs/src/content/docs/guides/compilation.md:

  1. Auto-detection table — replaced copilot target label with vscode, added .opencode/ folder row, updated "both folders" to "multiple target folders" to be inclusive
  2. Quick-start examples — changed --target copilot to --target vscode, added --target opencode example
  3. apm.yml example — changed target: copilot to target: vscode for consistency with CLI flag values
  4. Output files table — replaced copilot row with vscode, added opencode row with its generated files
  5. Aliases note — corrected to: "agents is an alias for vscode; copilot is accepted in apm.yml but not as a --target flag value"

Root Cause

The compilation guide was written using copilot as the target name, but the CLI's click.Choice only accepts ["vscode", "agents", "claude", "opencode", "all"]. copilot is handled internally by target_detection.py for apm.yml config but was never a valid --target flag. The OpenCode target was also not shown in the guide.

Merged PRs Referenced

Notes

The apm audit --dry-run wording and apm audit --drift planned-feature notice in enterprise/governance.md were already correctly documented and required no changes.

Generated by Daily Documentation Updater ·

To install this agentic workflow, run

gh aw add githubnext/agentics/workflows/daily-doc-updater.md@b87234850bf9664d198f28a02df0f937d0447295
  • expires on Mar 22, 2026, 3:38 AM UTC

…code

- Replace all copilot target references with vscode in the compilation guide
- Add --target opencode example to the quick-start block
- Add .opencode/ row to the auto-detection table
- Add opencode row to the output files table
- Clarify aliases note

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@danielmeppiel danielmeppiel added automation documentation Improvements or additions to documentation labels Mar 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant