Skip to content

docs: clarify skill contributions and ownership - #77

Merged
abretonc7s merged 4 commits into
mainfrom
docs/ownership-and-contributing
Jul 28, 2026
Merged

abretonc7s merged 4 commits into
mainfrom
docs/ownership-and-contributing

Conversation

@abretonc7s

Copy link
Copy Markdown
Contributor

Description

Updates the contribution guide and skill template to match the current repository layout. Adds complete domain ownership so reviews route to the responsible MetaMask teams.

Repository admins must grant listed teams explicit write access for GitHub to enforce team ownership.

Type of Change

  • Documentation update
  • Other: CODEOWNERS coverage

Checklist

  • I have read the CONTRIBUTING.md guidelines
  • My changes do not contain secrets or sensitive data
  • I have added appropriate documentation
  • My changes do not break existing skills

Testing

  • yarn test — 41 tests passed
  • yarn lint
  • git diff --check

@abretonc7s
abretonc7s marked this pull request as ready for review July 27, 2026 14:29
@abretonc7s
abretonc7s enabled auto-merge (squash) July 27, 2026 14:53
Comment thread CHANGELOG.md
Comment thread CONTRIBUTING.md
Comment thread .github/CODEOWNERS
Move the CONTRIBUTING rewrite under Changed, and show install
examples for multiple consumer repos.

@NicolasMassart NicolasMassart 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.

Looks good to me.

@abretonc7s
abretonc7s merged commit 06b5c90 into main Jul 28, 2026
27 checks passed
@abretonc7s
abretonc7s deleted the docs/ownership-and-contributing branch July 28, 2026 11:26
MajorLift added a commit that referenced this pull request Jul 30, 2026
#77 landed the contribution-doc corrections this branch was carrying —
clone URL, `domains/<area>/skills/` layout, lowercase `skill.md`, `repos/`
overlays — and rewrote `SKILL_TEMPLATE.md` independently. Both files resolve to
main's version rather than reapplying work already merged.

What remains unique is the pull-request template, which still asks for
**Provider Name:** — a field from the pre-domain layout that no longer exists.
It becomes **Domain:**.
andrepimenta added a commit that referenced this pull request Sep 7, 2026
Step 2 of docs/processes/releasing.md — "review the generated CHANGELOG.md
section and keep entries consumer-facing". The generated section needed it in
two places.

`### Uncategorized` held ten merged PRs that never got a hand-written entry.
Since `package.json` `files` ships `domains/` alongside `bin/` and `tools/`,
skill content reaches consumers on upgrade, so most of these are genuinely
user-facing and belong in the notes rather than being dropped. Rewritten from
the consumer's point of view and grouped by theme rather than one line per PR:
the component-view testing work (#109, #115, #132) reads as one change, as does
the Mobile testing default plus the Appium playbook move (#70, #54).

Dropped #63 and #77 — `.cursor` review rules and `.github`/`CONTRIBUTING`
changes are not in the published package, so an upgrading consumer sees nothing
of them.

`### Added` had the same problem less visibly: around a dozen raw
conventional-commit titles (`feat: add ...`, `feat(cli): ...`) that read as
commit log rather than release notes. Prefixes stripped, past tense applied.
Three were duplicates of curated entries for the same PR (#136, #75, and the
component-view flakiness line now covered by the #109 entry) and were removed.

Verified: `lint:changelog` passes, 69/69 tests, lint clean, `pack:dry-run` ok.
No `Uncategorized` section and no conventional-commit prefixes remain.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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