MVP · Hypothesis annotation test

Annotate this doc from any device.

This doc has the Hypothesis embed wired in. Open the URL on your phone, tablet, or laptop, log into Hypothesis once, and the sidebar opens. Highlight text, comment, reply. Everything you write is fetchable via API back into the editor.

#01How to try it

Open the sidebar from the icons on the top-right of the page (or in mobile, tap the small tab on the side). Sign in or create an account at hypothes.is. Select any text below and add a comment.

#02Things to annotate

Try highlighting any of the phrases below and leaving a comment. We will pull these into a JSON file next to this doc using the Hypothesis search API.

Highlight test #1

This is a short paragraph designed to be highlighted. Try selecting some text and leaving a comment.

Highlight test #2

Try a reply thread: comment, then reply to your own comment. Both should come back via the API.

Highlight test #3

Try tagging a comment with fix or question. The pull script can filter by tag.

#03Things that don't sync (yet)

These widgets are Hypothesis blind spots — state isn't captured anywhere unless we build it ourselves. Useful to confirm what we lose if we stay on Hypothesis only.

Tick this checkbox on your phone. Then open it on laptop — state will not transfer.
Same story for this one. Annotation-anchored comments are the workaround.
If checkbox state matters for our workflow, we revisit the custom-build option.

#04What the pull script returns

Running node pull-annotations.mjs <url> writes annotations.json next to this doc, with each highlight's exact text, the comment body, author, timestamp, and any tags. Claude reads that on the next iteration.