Skip to content

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

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

[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
Copy Markdown
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 Deprecated: use type/automation. Kept for issue history; will be removed in milestone 0.10.0. documentation Deprecated: use type/docs. Kept for issue history; will be removed in milestone 0.10.0. labels Mar 20, 2026
@github-actions
Copy link
Copy Markdown

This pull request was automatically closed because it expired on 2026-03-22T03:38:36.780Z.

Closed by Workflow

@github-actions github-actions Bot closed this Mar 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation Deprecated: use type/automation. Kept for issue history; will be removed in milestone 0.10.0. documentation Deprecated: use type/docs. Kept for issue history; will be removed in milestone 0.10.0.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant