Skip to content

docs: purge dangling .releaserc/semantic-release mentions (release-please follow-up) - #821

Merged
robsongajunior merged 1 commit into
mainfrom
docs/purge-releaserc-mentions
Jul 28, 2026
Merged

docs: purge dangling .releaserc/semantic-release mentions (release-please follow-up)#821
robsongajunior merged 1 commit into
mainfrom
docs/purge-releaserc-mentions

Conversation

@robsongajunior

@robsongajunior robsongajunior commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

Summary

Completes the repo-wide purge tracked in #818: five files still described the semantic-release / .releaserc mechanism deleted by #798 as if it were current. All verified against the tree before rewriting.

  • .claude/rules/compound-api.md (3 mentions), .claude/docs/COMPONENT_REQUIREMENTS.md (2), .claude/skills/component-scaffold/SKILL.md (1) — the .d.ts-at-publish claims now name the real mechanism: the publish workflow (.github/workflows/package-webkit.yml) runs vue-tsc --declaration --emitDeclarationOnly immediately before npm publish, triggered by release-please's release: published. The invariant they document is unchanged (.d.ts stays gitignored, generated at publish, never built in dev/CI) — only the "who runs it" was stale.
  • packages/webkit/docs/STYLEGUIDE.md:497 (ships to npm via #exports) — §15 Deprecation "Enforced by" now says release-please maps removal (! / BREAKING CHANGE:) to a major, instead of ".releaserc maps removal to a major".
  • docs/OVERVIEW_LINT.md §6 (commitlint) — rewritten beyond the three grep hits because the section was actively wrong, not just stale: the header example showed the leading-ticket form ([ENG-1231] feat(webkit): …) that commitlint now rejects and release-please cannot parse (the exact fix: use @aziontech/theme/animations imports; move vue-tsc to devDependencies #804 released-nothing trap), and the type table still listed hotfix (removed from the enum 2026-07-26) plus the old semantic-release chore/docs/style/refactor/perf → patch mapping. Now: squash-merged PR title is the parsed commit; ticket tag after the colon, only when a real ticket exists; feat → minor, fix → patch, everything else → no release on its own; the sync invariant names release-please-config.json instead of packages/*/.releaserc.

Closes #818. The sixth file from the issue (GOVERNANCE_IMPLEMENTATION.md) was handled by the #819 refresh in #820, which keeps one deliberate past-tense migration note.

Notes

…ease follow-up)

Five files still described the semantic-release mechanism deleted by #798. The d.ts-at-publish claims (compound-api.md, component-scaffold SKILL, COMPONENT_REQUIREMENTS, STYLEGUIDE) now name the publish workflow (package-webkit.yml runs vue-tsc --declaration --emitDeclarationOnly before npm publish, on release-please's release: published). OVERVIEW_LINT par 6 rewritten for release-please: squash-merged PR title is the parsed commit, ticket tag after the colon (the #804 trap), type table without hotfix (feat=minor, fix=patch, rest=none), sync invariant names release-please-config.json.
@robsongajunior
robsongajunior requested a review from a team as a code owner July 28, 2026 18:39
@robsongajunior
robsongajunior merged commit 62d0966 into main Jul 28, 2026
24 checks passed
@robsongajunior
robsongajunior deleted the docs/purge-releaserc-mentions branch July 28, 2026 22:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

docs: purge dangling .releaserc / semantic-release mentions (release-please follow-up)

4 participants