microsoft / microsoft/apm

docs(reference): experimental flags table omits the openclaw flag

Open Beginner friendly
#2,986 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

area/docs-site triage/recommended type/docs
Dominant language
Python
Stars
3.9k
Forks
365
Avg merge
1d 17h
Merged PRs (30d)
132

Description

docs/src/content/docs/reference/experimental.md says at line 21 that the command will "List every registered flag with its current state", and the "Available flags" table at line 168 is that list. The table has 8 rows. FLAGS in src/apm_cli/core/experimental.py:57 registers 9.

The missing one is openclaw, at experimental.py:128, described as "Deploy skills to OpenClaw agent runtime directories." Its hint points at --target openclaw and --target openclaw --global. Since it gates a real deploy target, someone reading the reference page to find out how to turn it on will not find it there.

The other eight line up exactly — verbose_version, copilot_cowork, copilot_app, grok_cloud, marketplace_authoring, registries, canvas, external_scanners — each rendered kebab-case in the table.

I checked today's CLI consistency report (#2985), which covers help-text wording and not this, and no open PR touches the file, out of 59 examined.

Happy to send the one-row addition if that is welcome.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Compare the Available flags table in docs/src/content/docs/reference/experimental.md with FLAGS in src/apm_cli/core/experimental.py, starting at the openclaw entry around line 128. Confirm the existing rows' kebab-case naming and the openclaw hint, then update the reference so all nine registered flags are represented, including its deployment-target description.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
cli, documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
92/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.