Skip to content

docs(reference): add openclaw to experimental flags table - #3366

Merged
Daniel Meppiel (danielmeppiel) merged 4 commits into
microsoft:mainfrom
MohammedAlkindi:docs/2986-openclaw-flag-row
Nov 12, 2026
Merged

Daniel Meppiel (danielmeppiel) merged 4 commits into
microsoft:mainfrom
MohammedAlkindi:docs/2986-openclaw-flag-row

Conversation

@MohammedAlkindi

Copy link
Copy Markdown
Contributor

Description

The experimental reference table listed 8 of the 9 FLAGS and omitted openclaw. This adds its row, with the registered description and a relative link to the OpenClaw guide.

Issue and approved scope

Issue: #2986

Fixes #2986

Human scope-approval comment: #2986 (comment)

Does this PR complete the issue, or what remains? It completes it.

Type of change

  • Bug fix
  • New feature
  • Documentation
  • Maintenance / refactor

Testing

  • Tested locally
  • All existing tests pass (docs checks only)
  • Added tests for new functionality (if applicable) (docs-only)

docs.yml steps run locally: test:links 14 pass, CLI docs contract tests 10 passed, npm run build and link checks clean, check_cli_docs.py 34/34, check_schema_ids.py 10/10.

Spec conformance (OpenAPM v0.1)

  • Spec edit: docs/src/content/docs/specs/openapm-v0.1.md updated
    (new/changed <a id="req-XXX"></a> anchor + prose + Appendix C
    row).
  • Manifest edit: docs/src/content/docs/specs/manifests/openapm-v0.1.requirements.yml
    updated.
  • Test edit: a @pytest.mark.req("req-XXX") test under
    tests/spec_conformance/ added or extended.
  • CONFORMANCE.{md,json} regenerated via
    uv run --extra dev python -m tests.spec_conformance.gen_statement
    and committed.
  • N/A -- this PR does not change OpenAPM-observable behaviour.

FLAGS in src/apm_cli/core/experimental.py registers nine flags, but the
Available flags table listed eight. Add the missing openclaw row with the
registered description and a relative link to the OpenClaw integration
page, matching the copilot-app, canvas and external-scanners rows.

Refs microsoft#2986.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@sergio-sisternes-epam

Copy link
Copy Markdown
Collaborator

Thanks for contributing this documentation correction. Issue #2986 has an explicit scope-approval record, and this PR appears to implement that scope. The requested reviewers include Daniel Meppiel (@danielmeppiel) and Sergio Sisternes (@sergio-sisternes-epam). This is a recommendation for human review only, not merge or approval.


Generated by autopilot-pr-triage-worker. This comment is AI-generated and may contain errors.

@sergio-sisternes-epam Sergio Sisternes (sergio-sisternes-epam) added area/docs-site docs/src/content (Starlight), README, doc generation. triage/recommended Automated advice completed; not human scope approval. type/docs Documentation change (prose, examples, generated reference). status/accepted Human scope approval; verify the issue's approval record and review contact before work. labels Nov 3, 2026
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@danielmeppiel

Copy link
Copy Markdown
Collaborator

APM Review Panel: ship_now

Clean one-row docs addition by a community contributor; all 9 registered experimental flags now appear exactly once in the Available flags table.

panel-mode=lean; personas=doc-writer,apm-ceo

cc Mohammed Alkindi (@MohammedAlkindi) Daniel Meppiel (@danielmeppiel) Sergio Sisternes (@sergio-sisternes-epam) -- a fresh advisory pass is ready for your review.

The doc-writer confirmed the openclaw row matches the registry description in src/apm_cli/core/experimental.py verbatim, the relative link ../../integrations/openclaw/ resolves to the existing OpenClaw guide, and the row follows the copilot-app / canvas / external-scanners pattern. No findings were raised, so there is nothing to arbitrate.

This delivers exactly the apm-scope:v1 record on #2986: one catalog row, experimental and disabled-by-default contract unchanged, guide reused rather than duplicated. Thanks Mohammed Alkindi (@MohammedAlkindi) for waiting for the scope record and shipping precisely that patch.

Aligned with: OSS community driven -- a scoped community patch landed as written. Governed by policy -- documents an existing flag without changing defaults or graduation status.

Panel summary

Persona B R N Takeaway
Doc Writer 0 0 0 Row matches the registry description word for word, link resolves, format fits neighbouring rows; all 9 flags appear once.

B = blocking-severity findings, R = recommended, N = nits.
Counts are signal strength, not gates. The maintainer ships.

Recommendation

Zero findings, registry parity confirmed against current main, and the contributor delivered exactly the approved scope. Ship now to keep contributor cycle time short and close the documentation gap. Fixes #2986 in the PR body closes the issue.

Folded in this run

  • No panel or Copilot follow-ups to fold. Merged current main into the branch (no conflicts; diff vs main is still the single docs line) -- head 1b7ae0ac88.

Copilot signals reviewed

  • Review 5623511633 -- NOT-LEGIT: quota notice with no review content; zero inline items.

Lint contract

Docs-only diff. ruff check and ruff format --check over src/ tests/ plus the CI-mirror script paths are silent on the merged head; the added line is ASCII-only.

CI

All required checks green on the merged head after approving the fork pull_request runs (no .github/ changes in the PR diff): CI (Lint, Build & Test shards, Lifecycle Smoke, Windows gates, Architecture ratchets), Merge Gate, Deploy Docs build, CodeQL, NOTICE Drift; license/cla pass (after 0 CI fix iteration(s)).

Mergeability status

PR head SHA CEO stance iters folds defers Copilot rounds CI mergeable mergeStateStatus notes
#3366 1b7ae0a ship_now 1 0 0 1 green MERGEABLE BLOCKED pending required review

Convergence

1 outer iteration(s); 1 Copilot round(s). Final panel stance: ship_now. Ready for maintainer review.

Full per-persona findings

Doc Writer

No findings.

This panel is advisory. It does not block merge. Re-apply the
panel-review label after addressing feedback to re-run.


Generated by autopilot-pr-review-worker. This comment is AI-generated and may contain errors.

@danielmeppiel
Daniel Meppiel (danielmeppiel) merged commit 9034594 into microsoft:main Nov 12, 2026
25 checks passed
@MohammedAlkindi
Mohammed Alkindi (MohammedAlkindi) deleted the docs/2986-openclaw-flag-row branch November 15, 2026 09:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs-site docs/src/content (Starlight), README, doc generation. status/accepted Human scope approval; verify the issue's approval record and review contact before work. triage/recommended Automated advice completed; not human scope approval. type/docs Documentation change (prose, examples, generated reference).

Projects

None yet

Development

Successfully merging this pull request may close these issues.

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

4 participants