Skip to content

Commit efe2582

Browse files
jt55401claude
andcommitted
docs: add Origin section, CONTRIBUTING.md, and FUNDING.yml
Three additions to make the repo welcoming and scoped: - README appendix: short note on the project's origin (Jason's idea since 2024, AI-assisted authoring and code) and an explicit out-of-scope list — debates about AI authorship, lists of trustworthy/untrustworthy signers, political/religious/personal philosophy. HTMLTrust is a mechanism, not a value judgment. - CONTRIBUTING.md: contribution flow, in-scope and out-of-scope items, license expectations, AI-assisted contribution disclosure norm, terse code of conduct. - .github/FUNDING.yml: GitHub Sponsors (jt55401) primary plus the secondary channels matching Jason's other repos. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 86fe752 commit efe2582

3 files changed

Lines changed: 75 additions & 0 deletions

File tree

.github/FUNDING.yml

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# GitHub Sponsors (primary)
2+
github: [jt55401]
3+
4+
# Secondary channels
5+
custom:
6+
- https://paypal.me/jt55401
7+
- https://venmo.com/Jason-Grey-1
8+
- bitcoin:1CJDZEJD86viU1L3kewMmXyx7VyPNcwzB9
9+
- ethereum:0xbC1240fe5F8e0732F7A0daA132a30982459Af5b3

CONTRIBUTING.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
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.

README.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -136,3 +136,19 @@ npm run test:coverage # With coverage report
136136

137137

138138
This project is licensed under the [PolyForm Noncommercial License 1.0.0](https://polyformproject.org/licenses/noncommercial/1.0.0). You may use, modify, and share the software for any noncommercial purpose with attribution. Commercial use requires a separate agreement with the licensor.
139+
140+
## Origin & Contributions
141+
142+
HTMLTrust is an idea I (Jason Grey) have been chewing on since 2024. I'm not an academic — I'm an engineer with a day job and a family — so the spec, the reference implementations, and most of this prose have been written with significant help from AI tools acting as research assistant, technical writer, and pair programmer. I wrote the original architectural sketches and reviewed every line; the assistants filled in the gaps and saved me from re-typing the same explanation for the hundredth time.
143+
144+
**Contributions are welcome — human or AI-assisted, doesn't matter to me.** What matters is whether the code, the spec text, or the conformance vectors move the project forward. Open a PR.
145+
146+
What this project is **not** a forum for:
147+
148+
- Debates about whether AI should be used to write code or specifications.
149+
- Opinions on who is or isn't trustworthy on the web.
150+
- Politics, religion, professional practice, or personal philosophy.
151+
152+
HTMLTrust is a mechanism — a way for *anyone* to sign content they publish and for *anyone* to decide whom they trust, on their own terms. The project takes no position on what the right answers are; it just provides the tools. If you want to debate the answers, there are entire continents of the internet better suited to it.
153+
154+
If this work is useful to you and you'd like to support it, see [GitHub Sponsors](https://github.com/sponsors/jt55401) or the other channels in [`.github/FUNDING.yml`](.github/FUNDING.yml).

0 commit comments

Comments
 (0)