|
| 1 | +# Contributing |
| 2 | + |
| 3 | +Thanks for helping move HTMLTrust forward. |
| 4 | + |
| 5 | +## Contribution Flow |
| 6 | + |
| 7 | +1. Fork the repository. |
| 8 | +2. Create a branch for your change. |
| 9 | +3. Run the project's existing checks (tests, linters, conformance vectors — |
| 10 | + see the README for the specific commands). |
| 11 | +4. Open a pull request against `main`. |
| 12 | + |
| 13 | +For larger changes (a new resolver, a new normalization phase, a new spec |
| 14 | +section), open an issue first to talk about scope. Saves everyone time. |
| 15 | + |
| 16 | +## What's in scope |
| 17 | + |
| 18 | +- Code, tests, and conformance vectors that improve any of the reference |
| 19 | + implementations. |
| 20 | +- Spec clarifications, examples, and edits that fix ambiguity. |
| 21 | +- Bug fixes, security fixes, performance improvements. |
| 22 | +- New language bindings of the canonicalization library that pass the |
| 23 | + conformance suite. |
| 24 | + |
| 25 | +## What's out of scope |
| 26 | + |
| 27 | +HTMLTrust is a mechanism, not a value judgment. The project does **not** |
| 28 | +accept contributions or issues for: |
| 29 | + |
| 30 | +- Debates over whether AI should or shouldn't be used to author software or specifications. |
| 31 | +- Lists of "approved" vs "disapproved" signers. |
| 32 | +- Political, religious, or philosophical positions on what content should be trusted. |
| 33 | +- Trust directory operator policies — those belong to the directory operators. |
| 34 | + |
| 35 | +The protocol is deliberately neutral so anyone can sign anything they |
| 36 | +publish and any user can decide for themselves whom to trust. If you want |
| 37 | +to debate the answers, that's a different project. |
| 38 | + |
| 39 | +## Legal and Attribution |
| 40 | + |
| 41 | +- By submitting a contribution, you agree your change is provided under the |
| 42 | + repository's license (`PolyForm-Noncommercial-1.0.0` for code repos, |
| 43 | + `CC-BY-NC-ND-4.0` for the spec and website). |
| 44 | +- Keep existing copyright, license, and notice text intact. |
| 45 | +- AI-assisted contributions are fine. If the contribution is substantial, |
| 46 | + briefly disclose the tools used in the PR description. |
| 47 | + |
| 48 | +## Code of Conduct |
| 49 | + |
| 50 | +Be technical. Be precise. Don't waste people's time. |
0 commit comments