Skip to content

docs: List the format and type commands, drop a stale npmignore note - #251

Merged
RobinBol merged 1 commit into
masterfrom
docs/tidy-tooling-notes
Oct 23, 2026
Merged

RobinBol merged 1 commit into
masterfrom
docs/tidy-tooling-notes

Conversation

@RobinBol

Copy link
Copy Markdown
Collaborator

What

Two leftovers from the tooling migration:

  • AGENTS.md lists format:check, format:write and generate-types next to the other commands, and the comment column is realigned to fit them.
  • docs.yml drops a note asking to add .github to .npmignore.

Why

Lint in CI now runs format:check, so a change that skips npm run format:write fails there. AGENTS.md did not mention the command.

There is no .npmignore and none is needed. files in package.json is an allowlist of index.d.ts and lib; npm pack --dry-run packs 60 files and nothing from .github.

Testing

npm run lint and npm run format:check clean. Every command listed in AGENTS.md exists in package.json.

AGENTS.md now lists format:check, format:write and generate-types next to
the other commands. Lint in CI runs format:check, so a change that skips
format:write fails there, and the file did not say the command exists.

docs.yml asked to add .github to .npmignore. There is no .npmignore and
none is needed: files in package.json is an allowlist of index.d.ts and
lib, so nothing else is packed.
@RobinBol RobinBol self-assigned this Oct 23, 2026
@RobinBol
RobinBol requested a balanced review from Copilot October 23, 2026 08:14

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.

🟢 Approval recommended

These documentation-only changes match the existing tooling and introduce no unresolved issues.

No open issues 🎉

What changed in this PR

Updates contributor guidance to reflect the existing tooling and removes an obsolete packaging comment without changing workflow behavior.

Changes:

  • Documents the formatting and type-generation commands in AGENTS.md.
  • Removes the stale .npmignore note from the documentation workflow.
File Description
AGENTS.md Adds three tooling commands and aligns their descriptions.
.github/​workflows/​docs.yml Removes an obsolete comment about excluding .github from packages.

Review effort: Balanced

@RobinBol
RobinBol marked this pull request as ready for review October 23, 2026 08:16
@RobinBol
RobinBol merged commit 4b642ca into master Oct 23, 2026
3 checks passed
@RobinBol
RobinBol deleted the docs/tidy-tooling-notes branch October 23, 2026 08:16
@RobinBol RobinBol added the internal Tooling, CI or docs, left out of the release notes label Oct 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal Tooling, CI or docs, left out of the release notes

Development

Successfully merging this pull request may close these issues.

2 participants