Skip to content

docs: drop stale release claims and repeated comments - #109

Merged
leoafarias merged 1 commit into
cursor/patch-manager-diff-cleanup-9d87from
cursor/stale-docs-comment-cleanup-3031
Oct 22, 2026
Merged

leoafarias merged 1 commit into
cursor/patch-manager-diff-cleanup-9d87from
cursor/stale-docs-comment-cleanup-3031

Conversation

@leoafarias

Copy link
Copy Markdown
Collaborator

Documentation and comments only. No runtime behavior change.

Website and skills

  • The API page now treats package:noir_driver as published and points at /docs/testing. checkReleaseClaims rejects repository-only once publication.json records that package. The API surface list stays at four cards.
  • The four "available in Noir 0.0.1" callouts are gone. The installation checkout is only for Noir source newer than publication.json.
  • The pre-0.0.1 mouse sentence is gone. The Noir skill distinguishes package:noir from published package:noir_driver, and its enableMouse notes match TuiApp.enableMouse: movement is on by default, and enableMovement: false is click and drag only.
  • The generator no longer emits the unused firstApp* exports. Unused .doc-ledger CSS and the stale "Only Noir is published" test comment are gone.

Library comments

  • The repeated payload-free intent constructor docs are gone. That file ignores public_member_api_docs so analysis stays green; the class docs name each command, and Intent already documents lookup by runtime type.
  • Historical sentences on Align and ThemeData are gone, as are the reinsertion sentences on State.deactivate and BuildContext.mounted.

Diff

56 insertions, 148 deletions.

Proof

  • npm ci, npm run sync:check, npm run format:check, npm run lint, npm run typecheck, NOIR_WEBSITE_BASE_PATH=/noir npm run build, NOIR_WEBSITE_BASE_PATH=/noir npm run test:smoke
  • From packages/noir: dart format --output=none --set-exit-if-changed lib/ test/ example/ bin/ hook/ tool/, dart analyze --fatal-infos, dart test test/docs test/architecture --concurrency=1
Open in Web Open in Cursor 

Published noir_driver and already-shipped APIs were still described as
repository-only or unreleased. Remove that prose, unused generated
exports, dead CSS, and repeated library comments. No behavior change.

Co-authored-by: Leo Farias <[email protected]>
@leoafarias
leoafarias changed the base branch from main to cursor/patch-manager-diff-cleanup-9d87 October 22, 2026 14:05
@leoafarias
leoafarias force-pushed the cursor/stale-docs-comment-cleanup-3031 branch from 33529b4 to d0dd023 Compare October 22, 2026 14:05
@leoafarias
leoafarias marked this pull request as ready for review October 22, 2026 14:05
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-22T14:13:03.371907Z d0dd023 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@leoafarias
leoafarias added this pull request to stack #117 October 22, 2026 14:05
@leoafarias
leoafarias removed this pull request from stack #117 October 22, 2026 14:11
@leoafarias
leoafarias added this pull request to stack #118 October 22, 2026 14:12

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d0dd023cf9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

);
}
for (const claim of repositoryOnly) {
if (!source.includes(claim)) continue;

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Scope the repository-only check to Noir Driver

If any MDX page describes an unrelated artifact as “repository-only” (for example, a test helper or maintenance script), this raw substring check reports that the page contradicts noir_driver publication and fails every documentation sync/build. Match the complete former Driver claim or otherwise establish that the phrase refers to noir_driver instead of prohibiting accurate use of the term across all website content.

Useful? React with 👍 / 👎.

Comment thread skills/noir/SKILL.md
Comment on lines +329 to +330
Drive mode is for looking at and driving a live app; automated assertions
belong in ordinary tests (`references/testing.md`).

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Allow NoirDriver for automated integration assertions

When an application needs to verify its painted output, this guidance says automated assertions should not use drive mode and links to a reference that repeats that prohibition. That contradicts the supported purpose of the newly published noir_driver client: applications add it as a dev dependency specifically to drive a live process and assert on painted frames. Distinguish these supported integration tests from Noir's private in-process widget harnesses instead of directing all automated assertions away from the driver.

AGENTS.md reference: AGENTS.md:L52-L55

Useful? React with 👍 / 👎.

@leoafarias
leoafarias merged commit 38b032f into main Oct 22, 2026
7 of 12 checks passed
@leoafarias
leoafarias deleted the cursor/stale-docs-comment-cleanup-3031 branch October 22, 2026 14:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants