{
"$type": "site.standard.document",
"bskyPostRef": {
"cid": "bafyreigolz66z6h2e6zbdzlzgudqvvsigtjslfbxfrylh4m43k5gntj5hu",
"uri": "at://did:plc:wz3tmummjex7sursdmzyar5e/app.bsky.feed.post/3mmf7asokavu2"
},
"path": "/notes/2026/05/2026-05-21-hypothesis/",
"publishedAt": "2026-05-21T13:00:00.000Z",
"site": "https://paulopinto.xyz",
"tags": [
"https://hypothes.is"
],
"textContent": "I’m using Hypothesis for my research because it lets me annotate primary texts and secondary literature directly in their original context, creating a searchable, shareable layer of precise notes and threaded discussion that maps onto the structure of arguments; this transforms isolated highlights into organized evidence I can filter by tag, trace through replies, and link straight into drafts and bibliographies. I find it amazing for how seamlessly it supports collaborative close reading—groups can build a living interpretive archive, preserve minority readings alongside mainstream ones, and maintain transparent provenance for every claim—so it speeds literature review, deepens interpretive rigor, and makes peer feedback immediate and traceable.\n\n### Setup\n\n 1. Install the Hypothesis browser extension or bookmarklet (Chrome/Firefox/Safari) or use the web client.\n 2. Create an account (or sign in via institution) and join/create a private group for your project.\n\n\n\n### Organize projects & sources\n\n 1. Create one group per project or research question.\n 2. Use consistent naming conventions for groups and tags (e.g., project_abbrev, lit_review, dataset).\n 3. Add metadata in each annotation: short title, authors, year, source URL, and concise note.\n\n\n\n### Reading & annotating workflow\n\n 1. Open a paper/webpage/PDF and enable Hypothesis.\n 2. Highlight key passages and add focused annotations:\n * **Summary:** 1–2 sentence gist of the passage.\n * **Note:** relevance to your research question.\n * **Method/Data:** record methods, sample size, key measurements.\n * **Quote:** exact text you may cite (use tags like quote).\n * **Critique/Question:** limitations or follow-up ideas.\n 3. Use tags for quick filtering: e.g., methods, result_conflict, support_hypothesis, to_check.\n\n\n\n### Collecting & organizing evidence\n\n 1. Use the sidebar’s search and filters (by group, user, tag, page) to assemble evidence.\n 2. Create saved searches or export annotation lists (CSV/JSON) for offline analysis.\n 3. Pin or star pivotal annotations.\n\n\n\n### Collaboration & peer review\n\n 1. Invite collaborators to the project group and set visibility (private/group/public).\n 2. Use replies for threaded discussion and to resolve interpretation disagreements.\n 3. Assign tasks by tagging collaborators or adding TODO notes in annotations.\n\n\n\n### Integrating with research tools\n\n 1. Export annotations to reference managers or note apps (manual copy, CSV/JSON, or integrations).\n 2. Link Hypothesis annotations in manuscripts or lab notebooks by URL.\n 3. Use Hypothesis with institutional platforms (JSTOR, library proxies, LMS) where available.\n\n\n\n### Managing literature reviews & writing\n\n 1. Build an annotated bibliography by tagging annotations as bib_entry and summarizing key citation info in the annotation body.\n 2. During drafting, search tags like support_hypothesis and contradiction to pull evidence for each claim.\n 3. Include direct annotation links in review drafts for reviewers to see context.\n\n\n\n### Reproducibility & transparency\n\n 1. Keep groups public or provide read-only links for reproducibility when appropriate.\n 2. Preserve raw notes: avoid overwriting—add new annotations instead of editing old ones when tracking interpretive changes.\n 3. Export annotation data as a project snapshot alongside code and data deposits.\n\n\n\n### Tips & best practices\n\n * Keep annotations concise and consistently structured.\n * Adopt a short tag taxonomy (5–10 tags) and document it in a group overview note.\n * Regularly review and reconcile duplicate or conflicting annotations.\n * Use private notes for tentative ideas; move important ones to the group when ready to share.\n\n\n\n==> go to https://hypothes.is",
"title": "How-to use Hypothesis for researchers"
}