Docs

Docs

These docs explain what possiblymadebyahuman is and is not, how the writing-record format works, how to verify a record from your own browser, and what a conformant producer has to do. They are deliberately short and candid.

Start with What this is and What we claim, and do not claim if you only have a few minutes.

If you’re looking for the producers themselves, write in the browser with the /write page or in Emacs with pmbah-mode.

To tie a record to the specific text you wrote, and let a reader check a document against it, see Bind and check a document.

• Bind and check a document
  Optionally bind the text you signed to a record, and let a reader check a document against it in their browser, comparing wording, not exact text.
• Content-blind privacy model
  What public records store, what they deliberately do not, and what the signer controls before upload.
• Deployment and routing
  How `/`, `/docs/*`, `/write`, `/api/*`, and `/<short_signature>` are served from a single container.
• How to verify a record
  Recompute the record's BLAKE3 hash in your own browser and compare it to the stored hash.
• Producer conformance
  What it takes for a producer (browser extension, Emacs minor mode, or anything else) to be considered conformant.
• Records and short signatures
  How a buffer mutation log becomes a hash-addressed record with a short, shareable URL.
• Server-observed commitments
  What the server-observed checkpoints on a record mean, and the limits of what they say.
• Terms / Service Notes
  What you can expect from this service, and what the service expects from you. v0, candid.
• Threat model
  Who and what this product can and cannot defend against.
• What this is
  A signed record of how a piece of writing was written, not a verdict about who wrote it.
• What we claim, and do not claim
  A short, candid list of what the record means and what it deliberately does not mean.
• Write in Emacs
  Native pmbah-mode for content-blind writing records from GNU Emacs.
• Write in the browser
  Use the first-party drafting page when you want a no-install PMBAH record for text written inside that page.