Summary
pkgs is opening to external contributions. Before we can accept pull requests from outside contributors, the Contributor License Agreement (CLA) machinery and contributor-facing documentation need to be in place. This issue tracks that rollout.
Background
Accepting work from outside contributors raises a question separate from the project's outbound license: on what terms has the contributor granted the right to include, distribute, and maintain their work. A CLA answers that once, up front, for every contributor — the standard instrument used by many large open-source projects. We use CLA Assistant for click-through Individual CLA signing, with a Corporate CLA available for contributions made on behalf of an employer.
Tasks
The steps below are in rough execution order — the CLA documents must be committed before CLA Assistant can be pointed at them.
Repository documentation
CLA Assistant
Merge gate
Validation
Coordination
Two ordering facts shape this:
- The CLA text must be committed before CLA Assistant can read it —
legal/ICLA.md has to be on main before the CLA Assistant configuration step.
- CLA Assistant goes live the moment it's configured — there is no staged or dry-run mode; it begins commenting on open pull requests and posting checks immediately.
So the contributor-facing change should land as one coordinated step: documents merged, README updated, then CLA Assistant configured. A half-rolled-out state — docs inviting contributions with no CLA gate, or a gate active with no CONTRIBUTING.md to explain it — is confusing for contributors.
Summary
pkgsis opening to external contributions. Before we can accept pull requests from outside contributors, the Contributor License Agreement (CLA) machinery and contributor-facing documentation need to be in place. This issue tracks that rollout.Background
Accepting work from outside contributors raises a question separate from the project's outbound license: on what terms has the contributor granted the right to include, distribute, and maintain their work. A CLA answers that once, up front, for every contributor — the standard instrument used by many large open-source projects. We use CLA Assistant for click-through Individual CLA signing, with a Corporate CLA available for contributions made on behalf of an employer.
Tasks
The steps below are in rough execution order — the CLA documents must be committed before CLA Assistant can be pointed at them.
Repository documentation
CONTRIBUTING.mdto the repo root; replace the[PROJECT NAME]placeholder with the repository's display name.legal/ICLA.md(Individual CLA) andlegal/CCLA.md(Corporate CLA). Paths matter —CONTRIBUTING.mdlinks to./legal/ICLA.mdand./legal/CCLA.md.README.mdto state that contributions are open, and to mention opening an issue as an alternative way to request a package.CLA Assistant
legal/ICLA.mdonmain(e.g.https://raw.githubusercontent.com/gominimal/pkgs/main/legal/ICLA.md). This makes the in-repo document the single source of truth. Note: CLA Assistant detects changes to the text and requires contributors to re-sign on their next PR — treat the file as versioned, don't edit it in place once live.dependabot[bot], etc.) so the gate doesn't block them.Merge gate
Validation
Coordination
Two ordering facts shape this:
legal/ICLA.mdhas to be onmainbefore the CLA Assistant configuration step.So the contributor-facing change should land as one coordinated step: documents merged, README updated, then CLA Assistant configured. A half-rolled-out state — docs inviting contributions with no CLA gate, or a gate active with no
CONTRIBUTING.mdto explain it — is confusing for contributors.