417 Matching Annotations
  1. Sep 2022
    1. @BenjaminVanDyneReplying to @ChrisAldrichI wish I had a good answer! The book I use when I teach is Joseph Harris’s “rewriting” which is technically a writing book but teaches well as a book about how to read in a writerly way.

      Thanks for this! I like the framing and general concept of the book.

      It seems like its a good follow on to Dan Allosso's OER text How to Make Notes and Write https://minnstate.pressbooks.pub/write/ or Sönke Ahrens' How to Take Smart Notes https://amzn.to/3DwJVMz which includes some useful psychology and mental health perspective.

      Other similar examples are Umberto Eco's How to Write a Thesis (MIT, 2015) or Gerald Weinberg's The Fieldstone Method https://amzn.to/3DCf6GA These may be some of what we're all missing.

      I'm reminded of Mark Robertson's (@calhistorian) discussion of modeling his note taking practice and output in his classroom using Roam Research. https://hyp.is/QuB5NDa0Ee28hUP7ExvFuw/thatsthenorm.com/mark-robertson-history-socratic-dialogue/ Perhaps we need more of this?

      Early examples of this sort of note taking can also be seen in the religious studies space with Melanchthon's handbook on commonplaces or Jonathan Edwards' Miscellanies, though missing are the process from notes to writings. https://www.logos.com/grow/jonathan-edwards-organizational-genius/

      Other examples of these practices in the wild include @andy_matuschak's https://www.youtube.com/watch?v=DGcs4tyey18 and TheNonPoet's https://www.youtube.com/watch?v=_sdp0jo2Fe4 Though it may be better for students to see this in areas in which they're interested.

      Hypothes.is as a potential means of modeling and allowing students to directly "see" this sort of work as it progresses using public/semi-public annotations may be helpful. Then one can separately model re-arranging them and writing a paper. https://web.hypothes.is/

      Reply to: https://twitter.com/BenjaminVanDyne/status/1571171086171095042

    1. 4 annotations of "GPT-3-ifying That Last Blogpost"

      This is cool. Something I should consider adding to my own sites. Just for the heck of it.

  2. Aug 2022
    1. https://www.reddit.com/r/antinet/comments/x2f4hn/should_i_always_create_a_bibnote/

      Here's a good example of my having written a response to something that only moments later disappeared thus roughly making my reply disappear and potentially be unfindable. Fortunately, Hypothes.is and my digital notes and content still remain, at least for me.

      Of course there was more context than my short highlight captured, but I still at least have the general gist.

    1. I am going to add some optional 'reading and doing' directions to my posts. Might be helpful.

      1. You might listen to the poem first.
      2. You might answer the question that Trethewey asks first. Maybe you can engage in the margins with it.
      3. You can make all or part of your responses public or private.
      4. You can start a group to consider the question.
      5. You can have at it in the order presented: my intro--> Twitter thread--> my response to the thread-->check out the link-->listen to the poem.
      6. Perch in the margins with the withered wild grapes and the black haw and the redbuds.
      7. Join in the work of forecasting your own life.
    1. we launched a service that’s now used by over a million people around the world who have made nearly 40 million annotations. In higher education, more than 1,200 colleges and universities use Hypothesis. And we’ve grown from a handful of people into a team of more than 35 passionate web builders.

      h. in 2022 has over 1 million users, who made nearly 40 million annotations. Early this year 2 million annotated articles/sites was reached (2175298 is the number the API rerurns today). This sounds like a lot but on its face works out to an average of 40 annotations on 2 articles per user. This suggests to me the mode is 1 annotation on 1 article per user. How many of those 1 million were active last week / month?

    1. "PDF is where documents go to die. Once something is in PDF, it's like a roach motel for data."

      —Chris Pratley, Microsoft Office's general manager (in TechRadar, 2012)

      obvious bias here on part of Pratley...

      Oddly, even if this were true, I'm not seeing patterns in the wild by which Microsoft products are helping to dramatically accelerate the distribution and easy ability to re-use data within documents. Perhaps its happening within companies or organizations to some extent, but it's not happening within the broader commons of the internet.

      If .pdfs are where information goes to die, then perhaps tools like Hypothes.is are meant to help resurrect that information?

    1. This is a living document. Ideas or feedback can be contributed through commenting directly using Hypothes.is which will create issues in the Github repo or you can directly create an issue: https://github.com/FAIRIslandProject/Generic-Place-based-Data-Policy/issues

      How awesome is this sort of integration? If one can use annotations to create issues within Github, it should be relatively easy for websites to do similar integrations to allow the use of Hypothes.is as a native commenting system on website pages. The API could be leveraged with appropriate URL wildcard patterns to do this.

      I have heard of a few cases of people using Github issue queues as comments sections for websites, and this dovetails well into that space.

      How might the Webmention spec be leveraged or abstracted to do similar sorts of communication work?

    1. Historical Hypermedia: An Alternative History of the Semantic Web and Web 2.0 and Implications for e-Research. .mp3. Berkeley School of Information Regents’ Lecture. UC Berkeley School of Information, 2010. https://archive.org/details/podcast_uc-berkeley-school-informat_historical-hypermedia-an-alte_1000088371512. archive.org.



      headshot of Charles van den Heuvel

      Interface as Thing - book on Paul Otlet (not released, though he said he was working on it)

      • W. Boyd Rayward 1994 expert on Otlet
      • Otlet on annotation, visualization, of text
      • TBL married internet and hypertext (ideas have sex)
      • V. Bush As We May Think - crosslinks between microfilms, not in a computer context
      • Ted Nelson 1965, hypermedia


      • Michael Buckland book about machine developed by Emanuel Goldberg antecedent to memex
      • Emanuel Goldberg and His Knowledge Machine: Information, Invention, and Political Forces (New Directions in Information Management) by Michael Buckland (Libraries Unlimited, (March 31, 2006)
      • Otlet and Goldsmith were precursors as well

      four figures in his research: - Patrick Gattis - biologist, architect, diagrams of knowledge, metaphorical use of architecture; classification - Paul Otlet, Brussels born - Wilhelm Ostwalt - nobel prize in chemistry - Otto Neurath, philosophher, designer of isotype

      Paul Otlet

      Otlet was interested in both the physical as well as the intangible aspects of the Mundaneum including as an idea, an institution, method, body of work, building, and as a network.<br /> (#t=1020)

      Early iPhone diagram?!?

      (roughly) armchair to do the things in the web of life (Nelson quote) (get full quote and source for use) (circa 19:30)

      compares Otlet to TBL

      Michael Buckland 1991 <s>internet of things</s> coinage - did I hear this correctly? https://en.wikipedia.org/wiki/Internet_of_things lists different coinages

      Turns out it was "information as thing"<br /> See: https://hypothes.is/a/kXIjaBaOEe2MEi8Fav6QsA

      sugane brierre and otlet<br /> "everything can be in a document"<br /> importance of evidence

      The idea of evidence implies a passiveness. For evidence to be useful then, one has to actively do something with it, use it for comparison or analysis with other facts, knowledge, or evidence for it to become useful.

      transformation of sound into writing<br /> movement of pieces at will to create a new combination of facts - combinatorial creativity idea here. (circa 27:30 and again at 29:00)<br /> not just efficiency but improvement and purification of humanity

      put things on system cards and put them into new orders<br /> breaking things down into smaller pieces, whether books or index cards....

      Otlet doesn't use the word interfaces, but makes these with language and annotations that existed at the time. (32:00)

      Otlet created diagrams and images to expand his ideas

      Otlet used octagonal index cards to create extra edges to connect them together by topic. This created more complex trees of knowledge beyond the four sides of standard index cards. (diagram referenced, but not contained in the lecture)

      Otlet is interested in the "materialization of knowledge": how to transfer idea into an object. (How does this related to mnemonic devices for daily use? How does it relate to broader material culture?)

      Otlet inspired by work of Herbert Spencer

      space an time are forms of thought, I hold myself that they are forms of things. (get full quote and source) from spencer influence of Plato's forms here?

      Otlet visualization of information (38:20)

      S. R. Ranganathan may have had these ideas about visualization too

      atomization of knowledge; atomist approach 19th century examples:S. R. Ranganathan, Wilson, Otlet, Richardson, (atomic notes are NOT new either...) (39:40)

      Otlet creates interfaces to the world - time with cyclic representation - space - moving cube along time and space axes as well as levels of detail - comparison to Ted Nelson and zoomable screens even though Ted Nelson didn't have screens, but simulated them in paper - globes

      Katie Berner - semantic web; claims that reporting a scholarly result won't be a paper, but a nugget of information that links to other portions of the network of knowledge.<br /> (so not just one's own system, but the global commons system)

      Mention of Open Annotation (Consortium) Collaboration:<br /> - Jane Hunter, University of Australia Brisbane & Queensland<br /> - Tim Cole, University of Urbana Champaign<br /> - Herbert Van de Sompel, Los Alamos National Laboratory annotations of various media<br /> see:<br /> - https://www.researchgate.net/publication/311366469_The_Open_Annotation_Collaboration_A_Data_Model_to_Support_Sharing_and_Interoperability_of_Scholarly_Annotations - http://www.openannotation.org/spec/core/20130205/index.html - http://www.openannotation.org/PhaseIII_Team.html

      trust must be put into the system for it to work

      coloration of the provenance of links goes back to Otlet (~52:00)

      Creativity is the friction of the attention space at the moments when the structural blocks are grinding against one another the hardest. —Randall Collins (1998) The sociology of philosophers. Cambridge, MA: Harvard University Press (p.76)

    1. Half the time I begin typing something, I'm not even sure what I'm writing yet. Writing it out is an essential part of thinking it out. Once I've captured it, re-read it, and probably rewritten it, I can then worry about what to label it, what it connects to, and where it should 'live' in my system.

      One of my favorite things about Hypothes.is is that with a quick click, I've got a space to write and type and my thinking is off to the races.

      Sometimes it's tacitly (linked) attached to another idea I've just read (as it is in this case), while other times it's not. Either way, it's coming out and has at least a temporary place to live.

      Later on, my note is transported (via API) from Hypothes.is to my system where I can figure out how to modify it or attach it to something else.

      This one click facility is dramatically important in reducing the friction of the work for me. I hate systems which require me to leave what I'm doing and opening up another app, tool, or interface to begin.

  3. Jul 2022
    1. For those curious about the idea of what students might do with the notes and annotations they're making in the margins of their texts using Hypothes.is, I would submit that Dan Allosso's OER handbook How to Make Notes and Write (Minnesota State Pressbooks, 2022) may be a very useful place to turn. https://minnstate.pressbooks.pub/write/

      It provides some concrete advice on the topic of once you've highlighted and annotated various texts for a course, how might you then turn your new understanding, ideas, and extant thinking work into a blogpost, essay, term paper or thesis.

      For a similar, but alternative take, the book How to Take Smart Notes: One Simple Technique to Boost Writing, Learning and Thinking by Sönke Ahrens (Create Space, 2017) may also be helpful as well. This text however requires purchase via Amazon and doesn't carry the Creative Commons Attribution NonCommercial ShareAlike (by-nc-sa 4.0) license that Dr. Allosso's does.

      In addition to the online copy of the book, there's an annotatable .pdf copy available here: http://docdrop.org/pdf/How-to-Make-Notes-and-Write---Allosso-Dan-jzdq8.pdf/ though one can download .epub and .pdf copies directly from the Pressbooks site.

    1. As marginal note-taking it often is the basis for questions asked in class discussion or points made in a final paper.

      Jeremy Dean indicates that marginal notes are often "the basis for [...] points made in a final paper", but I wonder how frequently this is the case in the computer era? I rarely see or hear of educators encouraging the reuse of marginalia or even notes in academic settings, even within the framing of Hypothes.is which is an ideal tool for such a practice.

      It's been my experience that while notes are in margins, they tend to sit there lonely and unused. Few are actually creating content based on them. When this is the case, memory of the idea or issue at hand is necessary so that it may be looked up and transcribed back into a bigger piece. When it does happen it's also far more likely to be academic writers or researchers who are concertedly building up particular areas. It's much less likely to be high school or undergraduate college students who should have picked up the practice earlier in junior high school or even elementary school so that their school research years are easier.

      A potential resurgence of this broader practice may be coming back into vogue with the slew of new note taking apps that have been popping up and the idea of the zettelkasten coming back into a broader consciousness.

    1. // NB: Since line terminators can be the multibyte CRLF sequence, care // must be taken to ensure we work for calls where `tokenPosition` is some // start minus 1, where that "start" is some line start itself.

      I think this satisfies the threshold of "minimum viable publication". So write this up and reference it here.

      Full impl.:

      getLineStart(tokenPosition, anteTerminators = null) {
        if (tokenPosition > this._edge && tokenPosition != this.length) {
          throw new Error("random access too far out"); // XXX
        // NB: Since line terminators can be the multibyte CRLF sequence, care
        // must be taken to ensure we work for calls where `tokenPosition` is some
        // start minus 1, where that "start" is some line start itself.
        for (let i = this._lineTerminators.length - 1; i >= 0; --i) {
          let current = this._lineTerminators[i];
          if (tokenPosition >= current.position + current.content.length) {
            if (anteTerminators) {
              anteTerminators.push(...this._lineTerminators.slice(0, i));
            return current.position + current.content.length;
        return 0;

      (Inlined for posterity, since this comes from an uncommitted working directory.)

  4. Jun 2022
    1. https://docs.google.com/document/d/1N4LYLwa2lSq9BizDaJDimOsWY83UMFqqQc1iL2KEpfY/edit

      P.R.O.B.E. rubric participation (exceeds, meets fails), respectful, open, brave, educational

      Mentioned in the chat at Hypothes.is' SOCIAL LEARNING SUMMIT: Spotlight on Social Reading & Social Annotation

      in the session on Bringing the Margins to Center: Introduction to Social Annotation

      Looking at the idea of rubrication, I feel like I ought to build a Tampermonkey or Greasemonkey script that takes initial capitals on paragraphs and makes them large, red, or even illuminated. Or perhaps something that converts the CSS of Hypothes.is and makes it red instead of yellow?

      What if we had a collection of illuminated initials and some code that would allow for replacing capitals at the start of paragraphs? Maybe a repository like giphy or some of the meme and photo collections for reuse?

    1. I very much appreciate your commitment to growth and learning. I also think it's nice to have colorful posts here vs. a ghost town. My feedback would be to gear your posts towards how to use an Antinet to produce written output. Specifically what main note you created, with pictures of the main note, and then elaborate on what they actually mean, and share a written post about the idea. You've done several of these posts, and I'd say lean even more towards sharing the most powerful thought/the most powerful maincard you've developed all week. For frequency, I'd say one post a week on this would be great.My main point is this: the primary use of Luhmann's Antinet was written output. The thoughts he shared were deep and developed because of the Antinet process. We're not in the PKM space, we're in the AKD space. Analog Knowledge Development, focusing on written output. The paradox is, when changing your mindset to written output, you actually become more of a learning machine.

      One of the toughest parts about these systems is that while they're relatively easy to outline (evidence: the thousands of 500-1000 word blog posts about zettelkasten in the last 3 years), they're tougher to practice and many people have slight variations on the idea (from Eminem's "Stacking Ammo" to Luhmann's (still incomplete) digital collection). Far fewer people are sticking with it beyond a few weeks or doing it for crazy reasons (I call it #ProductivityPorn, while Scott has the colorful phrase "bubble graph boys").

      For those who visit here, seeing discrete cards and ideas, videos, or examples of how others have done this practice can be immensely helpful. While it can be boring to watch a video of someone reading and taking notes by hand, it can also be incredibly useful to see exactly what they're doing and how they're doing it (though God bless you for speeding them up 😅).

      This is also part of why I share examples of how others have practiced these techniques too. Seeing discrete examples to imitate is far easier than trying to innovate your way into these methods, particularly when it's difficult to see the acceleration effects of serendipity that comes several months or years into the process. Plus it's fun to see how Vladimir Nabokov, Anne Lamott, Gottfried Wilhelm Leibniz, Bob Hope, Michael Ende, Twyla Tharp, Roland Barthes, Kate Grenville, Marcel Mauss, Claude Lévi-Strauss, Joan Rivers, Umberto Eco, Georg Christoph Lichtenberg, Raymond, Llull, George Carlin, John Locke, and Eminem all did variations of this for themselves. (This last sentence has so much entropy in it, I'm certain that it's never been written before in the history of humanity.)

      And isn't everyone tired to death of Luhmann, Luhmann, Luhmann? You'd think that no one had ever thought to take note of anything before?!

      While my own approach is a hybrid of online and offline techniques, I've gotten long emails from people following my Hypothes.is feed of notes and annotations saying what a useful extended example it is. Of course they don't see the follow up that entails revision of the notes or additional linking, tagging, and indexing that may go on, but it's at least enough of an idea that they understand the start of the practice.

      (Incidentally, I wrote most of this using a few cards from my own system. 🗃️✂️🖋️)

    1. By asking students to share their annotations openly, we help students to see a wide range of annotation practices, thus demystifying what has often been a private, individual practice.

      Teachers can model their own reading and annotating practices for students, but this can be expanded when using social annotation. This will allow students to show each other a wider variety of potential note taking and annotation strategies which help to reinforce the teacher's own modeling. This can be useful modelling of a practice in public which has historically been done privately.

      By featuring notes which might be reused for papers or developing later research, teachers can also feature the portions of the note taking process which can be reused for developing new ideas. How might annotations within a text be linked to each other outside of the particular flow of the paper? Might there have been different orderings for the arguments that may have been clearer?

      What ideas in the broader class might the ideas within a particular text be linked to? What ideas outside of the class can be linked to those found within the text?

      In less experienced groups, teachers might occasionally call out individual annotations in discussion to ask the group for what purposes a student might have annotated specific portions to highlight the various methods and reasons.

      What are the list of particular note types here? - Paraphrasing segments to self-test for understanding - Creation of spaced repetition type notes for memorizing definitions and facts - Conversations with the text/original author and expansion of the ideas - Questioning the original text, do we agree/disagree? - Linking ideas from the text into one's broader knowledge base - Highlighting quotes for later reuse - others??

      Link to - double-entry journaling in Bruce Ballenger<br /> - types of questions one might ask within a text, Ballenger again

    2. there is clear evidence that explicitly teaching reading strategies to students improves their overall academic performance, such instruction is often limited to developmental reading or study skills courses (Saxby 2017, 37-38).

      Teaching reading strategies to students improves their overall academic performance, but this instruction is often limited to developmental reading or study skills courses.

      ref: Saxby, Lori Eggers. “Efficacy of a College Reading Strategy Course: Comparative Study.” Journal of Developmental Education 40, no. 3 (2017): 36-38.

      Using Hypothes.is as a tool in a variety of courses can help to teach reading strategies and thereby improve students' overall academic performance.

    1. Some digital notes apps allow you to displayonly the images saved in your notes, which is a powerful way ofactivating the more intuitive, visual parts of your brain.

      Visual cues one can make in their notes and user interfaces that help to focus or center on these can be useful reminders for what appears in particular notes, especially if visual search is a possibility.

      Is this the reason that Gyuri Lajos very frequently cuts and pastes images into his Hypothes.is notes?

      Which note taking applications leverage this sort of visual mnemonic device? Evernote did certainly, but other text heavy tools like Obsidian, Logseq, and Roam Research don't. Most feed readers do this well leveraging either featured photos, photos in posts, or photos in OGP.

    1. I regularly check in on comments for this website and will generally respond!
    2. Although Hugo works with a number of commenting systems, I’ve chosen to use the social annotation software Hypothesis as the social layer on this website.


      Someone else using Hypothes.is as a commenting system in the wild.

    1. https://www.youtube.com/watch?v=fxfTVdohSwA

      Christine Moskell talks about a professor's final exam design prompting students to go back to annotations and add new commentary (or links to other related knowledge) that they've gained during the length of a course.

      Link to:

      This is very similar to the sort of sensemaking and interlinking of information that Sönke Ahrens outlines in his book How to Take Smart Notes though his broader note taking thesis goes a few additional steps for more broadly synthesizing ideas into longer papers, articles, theses, and books.

      Dr. Moskell also outlined a similar tactic at the [[Hypothesis Social Learning Summit - Spotlight on Social Reading & Social Annotation]] earlier today, though that video may not be accessible for a bit.

      Cross reference: https://web.hypothes.is/event/social-learning-summit-spotlight-on-social-reading-social-annotation/

      How can we better center and model these educational practices in our pedagogies?

    1. Real learning cannot happen in a vacuum. Connecting oneself and one’s new ideas with others across classrooms, across the curricula, and into the community build confidence , deepens experience, and maximizes success.
    1. The course Marginalia in Books from Christopher Ohge is just crying out to have an annotated syllabus.

      Wish I could follow along directly, but there's some excellent reference material hiding in the brief outline of the course.

      Perhaps a list of interesting people here too for speaking at https://iannotate.org/ 2022 hiding in here? A session on the history of annotation and marginalia could be cool there.

    2. Recommended preliminary reading  Antonini A., Benatti F., Blackburn-Daniels S. ‘On Links To Be: Exercises in Style #2’, 31st ACM Conference on Hypertext and Social Media (July 2020): 13–15. https://dl.acm.org/doi/10.1145/3372923.3404785   Grafton, Anthony. Worlds Made by Words : Scholarship and Community in the Modern West (Harvard UP, 2011).  Jackson, H. J. Marginalia: Readers Writing in Books (Yale UP, 2001).  –––. Romantic Readers: The Evidence of Marginalia (Yale UP, 2005).  Ohge, Christopher and Steven Olsen-Smith. ‘Computation and Digital Text Analysis at Melville’s Marginalia Online’, Leviathan: A Journal of Melville Studies 20.2 (June 2018): 1–16.  O’Neill, Helen, Anne Welsh, David A. Smith, Glenn Roe, Melissa Terras, ‘Text mining Mill: Computationally detecting influence in the writings of John Stuart Mill from library records’, Digital Scholarship in the Humanities 36.4 (December 2021): 1013–1029, https://doi.org/10.1093/llc/fqab010  Sherman, William. Used Books: Marking Readers in Renaissance England (U of Pennsylvania P, 2008).  Spedding, Patrick and Paul Tankard. Marginal Notes: Social Reading and the Literal Margins (Palgrave Macmillan, 2021). 

      An interesting list of readings on annotation.

      I'm curious if anyone has an open Zotero bibliography for this area? https://www.zotero.org/search/?p=2&q=annotation&type=group

      of which the following look interesting: - https://www.zotero.org/groups/2586310/annotation - https://www.zotero.org/groups/2423071/annotated - https://www.zotero.org/groups/2898045/social_annotation

      This reminds me to revisit Zocurelia as well: https://zocurelia.com

    1. Is it just me or is there something quirky with the rel="canonical" links for docdrop so that there isn't URL parity for the annotations on docdrop and the equivalent youtube videos. I thought it used to work, but when I visit the youtube version, there are no annotations on the page. I thought this used to work the way one would expect. What changed?

      I'm noticing that in this particular case there are two rel-canonical links when one might expect only one:

      <link rel="canonical" href="https://www.youtube.com/watch?v=XgMh6iuFbT4"><br /> <link rel="canonical" href="http://docdrop.org/video/XgMh6iuFbT4/">

      Maybe the docdrop link should be a rel="alternate" instead?

      cc: @dwhly

  5. May 2022
    1. I returned to another OER Learning Circle and wrote an ebook version of a Modern World History textbook. As I wrote this, I tested it out on my students. I taught them to use the annotation app, Hypothesis, and assigned them to highlight and comment on the chapters each week in preparation for class discussions. This had the dual benefits of engaging them with the content, and also indicating to me which parts of the text were working well and which needed improvement. Since I wasn't telling them what they had to highlight and respond to, I was able to see what elements caught students attention and interest. And possibly more important, I was able to "mind the gaps', and rework parts that were too confusing or too boring to get the attention I thought they deserved.

      This is an intriguing off-label use case for Hypothes.is which is within the realm of peer-review use cases.

      Dan is essentially using the idea of annotation as engagement within a textbook as a means of proactively improving it. He's mentioned it before in Hypothes.is Social (and Private) Annotation.

      Because one can actively see the gaps without readers necessarily being aware of their "review", this may be a far better method than asking for active reviews of materials.

      Reviewers are probably not as likely to actively mark sections they don't find engaging. Has anyone done research on this space for better improving texts? Certainly annotation provides a means for helping to do this.

    1. Writer and photographer Craig Mod wrote, “There is a gapingopportunity to consolidate our myriad marginalia* into an even morerobust commonplace book. One searchable, always accessible,easily shared and embedded amongst the digital text we consume.”6

      6 Craig Mod, “Post-Artifact Books and Publishing,” craigmod.com, June 2011, https://craigmod.com/journal/post_artifact/.

      It's not just me... I might hope that someone could leverage Hypothes.is' product to create a more explicit digital commonplace book out of their product.

    1. Projects like the Open Journal System, Manifold or Scalar are based on a distributed model that allow anyone to download and deploy the software (Maxwell et al., 2019), offering an alternative to the commercial entities that dominate the scholarly communication ecosystem.

      Might Hypothes.is also be included with this list? Though it could go a bit further toward packaging and making it more easily available to self-hosters.

    1. Nate Angell as our new Director of Communications and Community.

      Congratulations Nate! I'm sure Hypothes.is will miss you desperately, but Creative Commons will be all the better for your work and contribution.


  6. Apr 2022
    1. https://winnielim.org/library/collections/personal-websites-with-a-notes-section/

      Winnie has some excellent examples of people's websites with notes, similar to that of https://indieweb.org/note. But it feels a bit like she's approaching it from the perspective of deeper ideas and thoughts than one might post to Twitter or other social media. It would be worthwhile looking at examples of people's practices in this space that are more akin to note taking and idea building, perhaps in the vein of creating digital gardens or the use of annotation tools like Hypothes.is?

    1. We have to endlessly scroll and parse a ton of images and headlines before we can find something interesting to read.

      The randomness of interesting tidbits in a social media scroll help to put us in a state of flow. We get small hits of dopamine from finding interesting posts to fill in the gaps of the boring bits in between and suddenly find we've lost the day. As a result an endless scroll of varying quality might have the effect of making one feel productive when in fact a reasonably large proportion of your time is spent on useless and uninteresting content.

      This effect may be put even further out when it's done algorithmically and the dopamine hits become more frequent. Potentially worse than this, the depth of the insight found in most social feeds is very shallow and rarely ever deep. One is almost never invited to delve further to find new insights.

      How might a social media stream of content be leveraged to help people read more interesting and complex content? Could putting Jacques Derrida's texts into a social media-like framing create this? Then one could reply to the text by sentence or paragraph with their own notes. This is similar to the user interface of Hypothes.is, but Hypothes.is has a more traditional reading interface compared to the social media space. What if one interspersed multiple authors in short threads? What other methods might work to "trick" the human mind into having more fun and finding flow in their deeper and more engaged reading states?

      Link this to the idea of fun in Sönke Ahrens' How to Take Smart Notes.

    1. I’ll also note that there’s the potential of a reply on Hypothes.is to a prior reply to a canonical URL source. In that case it could be either marked up as a reply to the “parent” on Hypothesis and/or a reply to the canonical source URL, or even both so that webmentions could be sent further upstream.

      You can also "reply" by annotating the standalone (/a/...) page for a given annotation.

    2. Webmention functioning properly will require this canonical URL to exist on the page to be able to send notifications and have them be received properly

      It's also just annoying when trying to get at the original resource (or its URL for reference).

    3. all the data on this particular page seems to be rendered using JavaScript rather than being raw HTML
    4. I suspect that a reasonable WordPress user could probably set up a free Hypothes.is account and use the RSS feed from it (something like https://hypothes.is/stream.atom?user=username) to create an IFTTT.com recipe to post it as a public/draft to their WordPress website.

      This is a note. With an linked video

    5. I created a video overview/walkthrough of how I take highlights and annotations on Hypothes.isHypothes.is and feed them through to my WordPress Website using RSS and IFTTT.com.
    6. What follows may tend toward the jargon-y end of programming, but I’ll endeavor to explain it all and go step-by-step to allow those with little or no programming experience to follow along and use the tools I’m describing in a very powerful way.  I’ll do my best to link the jargon to definitions and examples for those who haven’t run across them before. Hopefully with a bit of explanation, the ability to cut and paste some code, or even make some basic modifications, you’ll be able to do what I and others have done, but without having to puzzle it all out from scratch.

      This is a note.

    1. The bookitself participates in the history it recounts: it has a title page, table of contents,footnotes, a bibliography and an index to assist the reader, while the digitalcopy enables the reader to search for individual words and phrases as well asto copy-and-paste without disfiguring a material object.

      Some scholars study annotations as part of material culture. Are they leaving out too much by solely studying those physically left in the books about which they were made, or should we instead also be looking at other sources like commonplace books, notebooks, note cards, digital spaces like e-readers that allow annotation, social media where texts are discussed, or even digital marginalia in services like Hypothes.is or Perusall?

      Some of these forms of annotation allow a digital version of cut and paste which doesn't cause damage to the original text, which should be thought of as a good thing though it may separate the annotations from the original physical object.

    1. You need to be in the triplescripts.org group to see this annotation.

      Membership is semi-private, but only as a consequence of current limitations of the Hypothes.is service.

      A copy of this annotation has been published in the Hypothes.is Public stream, which explains in detail that anyone is permitted to join.



    1. Ton has asked some good questions about social annotation using @Hypothes_is. I've annotated with some of my ideas. I'm also curious what others' practices look like.


      Come give your answers in the margins: https://via.hypothes.is/https://www.zylstra.org/blog/2022/04/three-questions-about-annotating-in-hypothesis/

      syndication links: - twitter - zylstra.org

    2. https://www.zylstra.org/blog/2022/04/three-questions-about-annotating-in-hypothesis/

      Thanks for asking these questions Ton! I've been meaning to spend some time writing up my use cases and methods for this for a while, and your questions have created a scaffold for getting a large chunk of it done in some bite sized pieces. Now I should be able to roll up my answers into an article, do some light editing and be on my way.

    3. 3. Who are you annotating with? Learning usually needs a certain degree of protection, a safe space. Groups can provide that, but public space often less so. In Hypothes.is who are you annotating with? Everybody? Specific groups of learners? Just yourself and one or two others? All of that, depending on the text you’re annotating? How granular is your control over the sharing with groups, so that you can choose your level of learning safety?

      This is a great question and I ask it frequently with many different answers.

      I've not seen specific numbers, but I suspect that the majority of Hypothes.is users are annotating in small private groups/classes using their learning management system (LMS) integrations through their university. As a result, using it and hoping for a big social experience is going to be discouraging for most.

      Of course this doesn't mean that no one is out there. After all, here you are following my RSS feed of annotations and asking these questions!

      I'd say that 95+% or more of my annotations are ultimately for my own learning and ends. If others stumble upon them and find them interesting, then great! But I'm not really here for them.

      As more people have begun using Hypothes.is over the past few years I have slowly but surely run into people hiding in the margins of texts and quietly interacted with them and begun to know some of them. Often they're also on Twitter or have their own websites too which only adds to the social glue. It has been one of the slowest social media experiences I've ever had (even in comparison to old school blogging where discovery is much higher in general use). There has been a small uptick (anecdotally) in Hypothes.is use by some in the note taking application space (Obsidian, Roam Research, Logseq, etc.), so I've seen some of them from time to time.

      I can only think of one time in the last five or so years in which I happened to be "in a text" and a total stranger was coincidentally reading and annotating at the same time. There have been a few times I've specifically been in a shared text with a small group annotating simultaneously. Other than this it's all been asynchronous experiences.

      There are a few people working at some of the social side of Hypothes.is if you're searching for it, though even their Hypothes.is presences may seem as sparse as your own at present @tonz.

      Some examples:

      @peterhagen Has built an alternate interface for the main Hypothes.is feed that adds some additional discovery dimensions you might find interesting. It highlights some frequent annotators and provide a more visual feed of what's happening on the public Hypothes.is timeline as well as data from HackerNews.

      @flancian maintains anagora.org, which is like a planet of wikis and related applications, where he keeps a list of annotations on Hypothes.is by members of the collective at https://anagora.org/latest

      @tomcritchlow has experimented with using Hypothes.is as a "traditional" comments section on his personal website.

      @remikalir has a nice little tool https://crowdlaaers.org/ for looking at documents with lots of annotations.

      Right now, I'm also in an Obsidian-based book club run by Dan Allosso in which some of us are actively annotating the two books using Hypothes.is and dovetailing some of this with activity in a shared Obsidian vault. see: https://boffosocko.com/2022/03/24/55803196/. While there is a small private group for our annotations a few of us are still annotating the books in public. Perhaps if I had a group of people who were heavily interested in keeping a group going on a regular basis, I might find the value in it, but until then public is better and I'm more likely to come across and see more of what's happening out there.

      I've got a collection of odd Hypothes.is related quirks, off label use cases, and experiments: https://boffosocko.com/tag/hypothes.is/ including a list of those I frequently follow: https://boffosocko.com/about/following/#Hypothesis%20Feeds

      Like good annotations and notes, you've got to put some work into finding the social portion what's happening in this fun little space. My best recommendation to find your "tribe" is to do some targeted tag searches in their search box to see who's annotating things in which you're interested.

    4. 2. What influence does annotating with an audience have on how you annotate? My annotations and notes generally are fragile things, tentative formulations, or shortened formulations that have meaning because of what they point to (in my network of notes and thoughts), not so much because of their wording. Likewise my notes and notions read differently than my blog posts. Because my blog posts have an audience, my notes/notions are half of the internal dialogue with myself. Were I to annotate in the knowledge that it would be public, I would write very differently, it would be more a performance, less probing forwards in my thoughts. I remember that publicly shared bookmarks with notes in Delicious already had that effect for me. Do you annotate differently in public view, self censoring or self editing?

      To a great extent, Hypothes.is has such a small footprint of users (in comparison to massive platforms like Twitter, Facebook, etc.) that it's never been a performative platform for me. As a design choice they have specifically kept their social media functionalities very sparse, so one also doesn't generally encounter the toxic elements that are rampant in other locations. This helps immensely. I might likely change my tune if it were ever to hit larger scales or experienced the Eternal September effect.

      Beyond this, I mostly endeavor to write things for later re-use. As a result I'm trying to write as clearly as possible in full sentences and explain things as best I can so that my future self doesn't need to do heavy work or lifting to recreate the context or do heavy editing. Writing notes in public and knowing that others might read these ideas does hold my feet to the fire in this respect. Half-formed thoughts are often shaky and unclear both to me and to others and really do no one any good. In personal experience they also tend not to be revisited and revised or revised as well as I would have done the first time around (in public or otherwise).

      Occasionally I'll be in a rush reading something and not have time for more detailed notes in which case I'll do my best to get the broad gist knowing that later in the day or at least within the week, I'll revisit the notes in my own spaces and heavily elaborate on them. I've been endeavoring to stay away from this bad habit though as it's just kicking the can down the road and not getting the work done that I ultimately want to have. Usually when I'm being fast/lazy, my notes will revert to highlighting and tagging sections of material that are straightforward facts that I'll only be reframing into my own words at a later date for reuse. If it's an original though or comment or link to something important, I'll go all in and put in the actual work right now. Doing it later has generally been a recipe for disaster in my experience.

      There have been a few instances where a half-formed thought does get seen and called out. Or it's a thought which I have significantly more personal context for and that is only reflected in the body of my other notes, but isn't apparent in the public version. Usually these provide some additional insight which I hadn't had that makes the overall enterprise more interesting. Here's a recent example, albeit on a private document, but which I think still has enough context to be reasonably clear: https://hypothes.is/a/vmmw4KPmEeyvf7NWphRiMw

      There may also be infrequent articles online which are heavily annotated and which I'm excerpting ideas to be reused later. In these cases I may highlight and rewrite them in my own words for later use in a piece, but I'll make them private or put them in a private group as they don't add any value to the original article or potential conversation though they do add significant value to my collection as "literature notes" for immediate reuse somewhere in the future. On broadly unannotated documents, I'll leave these literature notes public as a means of modeling the practice for others, though without the suggestion of how they would be (re-)used for.

      All this being said, I will very rarely annotate things privately or in a private group if they're of a very sensitive cultural nature or personal in manner. My current set up with Hypothesidian still allows me to import these notes into Obsidian with my API key. In practice these tend to be incredibly rare for me and may only occur a handful of times in a year.

      Generally my intention is that ultimately all of my notes get published in something in a final form somewhere, so I'm really only frontloading the work into the notes now to make the writing/editing process easier later.

    5. How do you get your annotations into the rest of your workflow for notes and learning? How do you prevent that your social annotation tool is yet another separate place where one keeps stuff, cutting off the connections to the rest of one’s work and learning that would make it valuable?


      My annotations broadly flow into two spaces:


      My private Obsidian-based vault is where I collect the notes and actively work on, modify, edit, and expand them if and when necessary. This is also the space where I'm broadly attempting to densely interlink them together for future use and publication in other venues. If I could, I would publish these all on the web, but I've yet to find a set up with a low enough admin tax that I can publish them inexpensively in a way I'd like them to appear (primarily with properly linked [[WikiLinks]]) while still owning them in my own space.

      I've been experimenting around with using Blot.im as a solution to display them here https://notes.boffosocko.com/, but at present it's a very limited selection of my extant notes and doesn't include Webmention or other niceties I'd like to add. As it's a very alpha stage experiment I don't recommend anyone follow or use it and it may disappear altogether in the coming months.


      My main website uses WordPress. To a great extent, this is (now) primarily a back up location and the majority of the annotations are unpublished to the public, but are searchable to me on the back end.

      I do, however, use it occasionally for quickly publishing and syndicating select annotations which I think others may find interesting or upon which I'm looking for comments/feedback and don't expect that the audience I'd like these from will find them natively on Hypothes.is' platform. An example of this might be a paper I was reading this weekend on Roland Barthes which discusses his reasonably well documented zettelkasten-like note taking practice. The article can be found here: https://culturemachine.net/wp-content/uploads/2019/01/373-604-1-PB.pdf with the annotations seen here: https://docdrop.org/pdf/The-Card-Index-as-Creativity-Ma---Wilken-Rowan-upq8g.pdf/. To tip off others in the space, I made a post on my site with a bit of a puzzle and syndicated it to Twitter. A few hours later I posted a follow up with some additional details and links to my notes on hypothesis which got some useful feedback from Matthias Melcher on the Barthes paper as well as on a related paper I mentioned by Luhmann, particularly about German translation, with which I have little facility.

      Another recent illustrative example was this annotation on the Library of Congress website about Vladimir Nabokov which was picked up by my website (though unpublished/not public) but which I syndicated to Twitter primarily to be able to send a notification to Eleanor Konik who I know is interested in the idea of World Building using historical facts and uses Obsidian in her work. (The @mention in the tweet is hiding in the image of the index card so that I could save text space in the main tweet.) Several others interested in note taking and zettelkasten for writing also noticed it and "liked" it. Not being on Hypothes.is to my knowledge much less following me there, neither Eleanor nor the others would have seen it without the Tweet.

      Nabokov used index cards for his research & writing. In one index card for Lolita, he creates a "weight-heigh-age table for girls of school age" to be able to specify Lolita's measurements. He also researched the Colt catalog of 1940. #WorldBuildinghttps://t.co/i16Yc7CbJ8 pic.twitter.com/JSjXV50L3M

      — Chris Aldrich (@ChrisAldrich) April 10, 2022
      <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>



      Getting annotations from Hypothes.is to Obsidian is a short two-step process which is reasonably well automated so that I don't spend a lot of time cutting/pasting/formatting.

      I start with an IFTTT recipe that takes the RSS output of Hypothes.is and creates text files directly into my Obsidian vault. The results are quite rudimentary and only include the title of the document, the permalink of the Hypothes.is post, the highlighted text, and my annotation. It doesn't include the tags as RSS doesn't have a specification for these.

      Second, I've set up Hypothesidian which has a much higher fidelity dovetail with the Hypothes.is API to get all the data and even the formatting set up I'm looking for. A reasonably well laid out set of instructions with a low/no code approach for it can be found at https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225. It allows importing annotations by a variety of methods including by date and by document URL. I've also made a small modification to it so that tags on Hypothes.is are turned into [[wikilinks]] in Obsidian instead of #tags which I only use sparingly.

      All the IFTTT annotations will be ported individually into a specific Obsidian folder where I'll process them. I can then quickly use Hypothesidian to import the properly laid out version (using templates) of the notes with just a few keystrokes and then focus my time on revising my notes if necessary and then linking them to the appropriate notes already in my system. Finally I'll move them into the appropriate folder based on their content—typically one of the following: zettelkasten, wiki, commonplace, dictionary, or sources (for bibliographic use). Careful watchers will notice that I often use Hypothes.is' "page notes" functionality to create a bookmark-like annotation into which I will frequently post the URL of the page and occasionally a summary of a piece, these are imported into my system and are used as source/bibliographic information. I also have some dovetailing with Zotero as a bibliographic set up which feeds into this data as well.

      This version which I've cobbled together works well for me so that I'm not missing anything, but there are definitely other similar processes available out there both for Obsidian (with plugins or scripts) as well as for other platforms. If I'm not mistaken, I think Readwise (a paid solution) has a set up for note transfer and formatting.


      As there isn't an extant Micropub client for Hypothes.is I initially used RSS as a transport layer to get my notes from Hypothes.is into WordPress. The fidelity isn't great in part because RSS doesn't include any tags. To get some slightly better presentation I set up a workflow using RSS output from Hypothes.is as input into an IFTTT workflow which outputs to a webhook that stands in as a Micropub client targeting my websites Micropub server. Some of the display on my site is assisted by using the Post Kinds plugin, which I know you've been working around yourself. The details may be above some, but I've outlined most of the broad strokes of how this is done in a tutorial at https://boffosocko.com/2020/01/21/using-ifttt-to-syndicate-pesos-content-from-social-services-to-wordpress-using-micropub/. In that example, I use the service Pocket as an example, but Hypothes.is specific information could easily be swapped out on a 1-1 basis.

      A custom stand-alone or even an integrated micropub client for Hypothes.is would be a fantastic project if someone wanted to dig into the details and dovetail it with the Hypothes.is API.


      Ideally, I'm hoping that small pieces loosely joined and IndieWeb building blocks will allow me to use the tools and have the patterns I'm looking for, without a lot of work, so that I can easily make annotations with Hypothes.is but have and share (POSSE) my content on my own site in a way that works much the way many IndieWeb sites dovetail with Twitter or Mastodon.

      I'm doing some portions of it manually at present, without a lot of overhead, but it would be fun to see someone add micropub and webmention capabilities to Hypothes.is or other IndieWeb building blocks. (I suspect it won't be Hypothes.is themselves as their team is very small and they're already spread thin on multiple other mission critical projects.)

      In the end, I'm using Hypothes.is as a well designed and convenient tool for quickly making notes on digital documents. All the data is flowing to one of two other locations where I'm actually making use of it. While there is some social layer there, I'm getting email notifications through the Hypothes.is settings and the data from my responses just gets rolled back into my spaces which I try to keep open and IndieWeb friendly by default. At the same time, for those who want or need it, Hypothes.is' interface is a great way of reading, searching, sorting, and interacting with my notes in public, particularly until I get something specific and user friendly up to do it on my own domain.

    6. Tools like Hypothes.is are designed as silos to ensure that its social features work.

      As open source as Hypothes.is is, I do wish that it had some additional open IndieWeb building blocks to keep it from being a silo.

      Sadly, I've never had the time, nor the technical expertise and facility with their code to implement the pieces, but I have outlined a bit of what might be done to make the platform a bit less silo-like: https://boffosocko.com/2019/04/08/ideas-for-indieweb-ifying-hypothes-is/

      Fortunately it is open enough for me in other respects that I can bend portions of it to my will and needs beyond what it offers a la carte.

    1. Much of Barthes’ intellectual and pedagogical work was producedusing his cards, not just his published texts. For example, Barthes’Collège de France seminar on the topic of the Neutral, thepenultimate course he would take prior to his death, consisted offour bundles of about 800 cards on which was recorded everythingfrom ‘bibliographic indications, some summaries, notes, andprojects on abandoned figures’ (Clerc, 2005: xxi-xxii).

      In addition to using his card index for producing his published works, Barthes also used his note taking system for teaching as well. His final course on the topic of the Neutral, which he taught as a seminar at Collège de France, was contained in four bundles consisting of 800 cards which contained everything from notes, summaries, figures, and bibliographic entries.

      Given this and the easy portability of index cards, should we instead of recommending notebooks, laptops, or systems like Cornell notes, recommend students take notes directly on their note cards and revise them from there? The physicality of the medium may also have other benefits in terms of touch, smell, use of colors on them, etc. for memory and easy regular use. They could also be used physically for spaced repetition relatively quickly.

      Teachers using their index cards of notes physically in class or in discussions has the benefit of modeling the sort of note taking behaviors we might ask of our students. Imagine a classroom that has access to a teacher's public notes (electronic perhaps) which could be searched and cross linked by the students in real-time. This would also allow students to go beyond the immediate topic at hand, but see how that topic may dovetail with the teachers' other research work and interests. This also gives greater meaning to introductory coursework to allow students to see how it underpins other related and advanced intellectual endeavors and invites the student into those spaces as well. This sort of practice could bring to bear the full weight of the literacy space which we center in Western culture, for compare this with the primarily oral interactions that most teachers have with students. It's only in a small subset of suggested or required readings that students can use for leveraging the knowledge of their teachers while all the remainder of the interactions focus on conversation with the instructor and questions that they might put to them. With access to a teacher's card index, they would have so much more as they might also query that separately without making demands of time and attention to their professors. Even if answers aren't immediately forthcoming from the file, then there might at least be bibliographic entries that could be useful.

      I recently had the experience of asking a colleague for some basic references about the history and culture of the ancient Near East. Knowing that he had some significant expertise in the space, it would have been easier to query his proverbial card index for the lived experience and references than to bother him with the burden of doing work to pull them up.

      What sorts of digital systems could help to center these practices? Hypothes.is quickly comes to mind, though many teachers and even students will prefer to keep their notes private and not public where they're searchable.

      Another potential pathway here are systems like FedWiki or anagora.org which provide shared and interlinked note spaces. Have any educators attempted to use these for coursework? The closest I've seen recently are public groups using shared Roam Research or Obsidian-based collections for book clubs.

    1. https://hypothes.is/a/krnfMl0pEeyvKGMTU02-Lw

      stuhlmueller Dec 14, 2021

      Elicit co-founder here - feel free to leave feedback through hypothesis, we're reading it. :)

      Example in the wild of a company using Hypothes.is to elicit (pun intended) feedback on their product.

    1. An initial stage of annotation might be provided bya professional reader hired to add aids to reading for the owner, including espe-cially mnemonic or meditative aids, or enhancements to the layout, but alsooccasionally self-reflexive or potentially dissenting observations.24 A successionof owner-readers could then add further corrections and comments.

      Stages of annotation in the medieval period

      When is Hypothes.is going to branch out into the business of professional readers to add aids to texts?! :)

      Link this to the professional summary industry that reads books and summarizes them for busy executives

      Link this to the annotations studied by Owen Gingerich in The Book Nobody Read.

    2. Starting in the Renaissance notes weretreated less as temporary tools than as long-term ones, worthy of considerableinvestment of time and effort, of being saved for reuse and in some cases sharedwith others (collaborators in a project or one’s colleagues or heirs). Collections ofnotes were valued as treasuries or storehouses in which to accumulate informa-tion even if they did not serve an immediate purpose. This stockpiling approachto note-taking also required greater attention to organization and finding devicessince the precise uses to which the notes might be put were not clear from theoutset and the scale of accumulation hampered memorization.

      Summary tk

      Modern note taking has seen a reversion to pre-Renaissance practices in which they're much more temporary tools. Relatively few students take notes with an aim for reusing them past their immediate classroom settings or current term of study.

      The revitalization of the idea of the zettelkasten in the late 2010s seems to be helping to reverse this idea. However, there aren't enough online versions of these sorts of notes which allow them to be used with other publics or even to be used and shared with other collaborators. There are some growing spaces seen in the social media note taking space like the anagora.org or the digital gardens space where this seems to have some potential to take off. There's also a small community on Hypothes.is which seems to be practicing this as well, though direct links between various collections of notes is not commonplace.

  7. Mar 2022
    1. With Hypothesis, you can add suggestions and additions as an overlay on current content easily and quickly.  For example, you can provide proper citations or additional information on a topic, note grammatical errors or factual inaccuracies. Experienced Wikipedia editors can then follow up and work with you to add your recommendations to the article.

      The problem with this, generally, but esp. affecting wikis in particular, is that you end up with orphaned and irrelevant/out-of-date annotations.

      Hypothes.is should select an appropriate link relation (in the vein of what it now does with canonical) and scope the annotation appropriately—even if the user does not actually have his or her browser pointed at the exact revision that is "current".

    1. I already have several highlights made by external pdf applications like ocular. These annotations are being detected by the pdf viewer used by this plugin. I wanted a way to add the existing annotations to markdown instead of having to repeat the process. As you can see, the highlights' metadata is being detected upon clicking the highlights. What can be done is add 2 options - Either import all existing annotations and highlights Import the selected annotation/highlight I would love to see this feature being added

      The work to add this particular feature to the plugin may be quite a lot, but for those who want it in the erstwhile and for the developers as an example, one might try looking at https://forum.obsidian.md/t/zotero-zotfile-mdnotes-obsidian-dataview-workflow/15536.

    1. Is there a setting (or would it be possible to add one) so I can change the width of the sidebar with the annotations? On my bigger monitor it's ok, but on my normal screen I can barely see the actual PDF and the side bar covers almost half the screen. Also, I had a very hard time getting the plugin to actually find the file. It couldn't find it anywhere aside from the same folder the annotation note is in. (I tried a different folder in the vault, as well as an absolute path on my PC.) Aside from that, love the plugin! Thanks :)

      The ability to resize the Hypothes.is drawer is already built into the Hypothes.is interface natively. In the top left of the drawer there is a ">" tab that you can drag to resize the annotations window to suit your needs. Clicking on it will allow you to open and close the pane as needed. If it's closed (the icon appears as "<"), you can highlight and choose "annotate" or "highlight" and it will automatically re-open the Hypothes.is interface.

    1. I've been using the Hypothesis Obsidian annotator to annotate PDFs in an Obsidian vault—so I have a bunch of annotations as markdown files. I am now attempting to publish the Obsidian vault as a website at movement-ontology.brandazzle.net, but the plugin apparently isn't supported on website, as the annotations do not render. Is there any way I could host the Hypothesis tools on the website and connect my annotations so that viewers can see my annotations?


      Obsidian Annotator (https://github.com/elias-sundqvist/obsidian-annotator), which I'm presuming you're using, looks like it's working from within Obsidian instead of a web page and is very clever looking, but without some significant work, I don't think it's going to provide you with the results you're looking for. It sounds like you want an all-public chain of work and Obsidian Annotator currently defaults to an all-private chain.

      From my brief perusal of what's going on, the plugin appears to be tied to a single Hypothes.is account (likely the developer's) which defaults all annotations to private (only you) and as a result, even if you had the permalink to the annotations you'd not be able to see them presented on the web as they're all private and you wouldn't have access to the account. You could try filing some issues on the related Github repository to see if the developer might add the ability to make public annotations using your own personal account, which I'm sure would require your personal API key for Hypothes.is to be put into the settings page for the plugin in Obsidian. Another issue I see is that it's taking Hypothesis tags and turning them into Obsidian tags, which is generally fine, but the developer isn't accounting for multi-word tags which is creating unintended tag errors along the way that will need to be manually fixed.

      If you're open to an alternate method of annotating and doing so in public, I can recommend a workflow that will allow you to do what it sounds like you're attempting. It starts with annotating .pdf files (either on the web, or as local files in your browser) in public using your own Hypothes.is account. (Most of this also works with private annotations, but if you want them to appear on public versions of web-hosted .pdf files with the same fingerprints, you'll want them to be public so others can see/interact with them.) Next set up the Hypothesidian script described here: https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225. There are some useful hints further down the thread on that page, so read the whole thing. The Github repository for it is here: https://github.com/SilentVoid13/Templater/discussions/191 if you need it. I've documented a few modifications I've made to the built-in template to suit my particular needs and which might serve as a template if you find it useful: https://boffosocko.com/2021/07/08/hypothes-is-obsidian-hypothesidian-for-easier-note-taking-and-formatting/.

      You can then use the functionality of Hypothesidian to pull in the annotations you want (by day, by document, only your annotations, all the annotations on a document, etc.) For .pdf files, you may require Jon Udell's facet tool https://jonudell.info/h/facet/ to search your personal account for the name of the file or one of the tags you used. When you find it, you can click on it and it will open a new browser window that contains the appropriate urn file "key" you'll need to put into Hypothesidian to grab the annotations from a particular .pdf file. It will be in the general form: urn:x-pdf:1234abcd5678efgh9101112ijkl13. I haven't found an easier means of pulling out the URN/fingerprint of pdf files, though others may have ideas.

      When you pull in your annotations you can also get/find permalinks to the annotations on the web if you like. I usually hide mine in the footnotes of pages with the labels "annotation in situ" and "syndication links", a habit I've picked up from the IndieWeb community (https://indieweb.org/posts-elsewhere). You can see a sample of how this might be done at https://notes.boffosocko.com/where-are-the-empty-spaces-on-the-internet where I've been doing some small scale Hypothes.is/Obsidian/Web experiments. (I'm currently using Blot.im to get [[wikilinks]] to resolve.)

      Another strong option you're probably looking for is to use "via" links (https://web.hypothes.is/blog/meetvia/) on the URLs for your pdf files so that people can automatically see the annotation layer. (This may require whitelisting on Hypothes.is' end depending on where the files are hosted; alternately https://docdrop.org/ may be useful here.) Then if you've annotated those publicly, they'll also be able to see them that way too.

      Another side benefit of this method is that it doesn't require the Data View plugin for Obsidian to render your annotations within Obsidian which also means you'll have cleaner looking pages of annotations in your web published versions. (ie. none of the %% code blocks which don't render properly on the web)

      As I notice you're using some scanned .pdf files which often don't have proper OCR and can make creating annotations with appropriate Hypothes.is anchors, you might also appreciate the functionality of docdrop for this as well.

      Given your reliance on documents and the fact that you've annotated some in what looks like Adobe Acrobat or a similar .pdf program, you might additionally enjoy using Zotero with Obsidian, Zotfile, and mdnotes as outlined here: https://forum.obsidian.md/t/zotero-zotfile-mdnotes-obsidian-dataview-workflow/15536. It's relatively slick, but requires additional set up, reliance on more moving pieces, and isn't as nice an overall user interface in comparison to Hypothes.is. It also misses all of the potential useful social annotation you might get with Hypothes.is.

      Hopefully this is all reasonably clear and helpful. I'd be interested in hearing about options from others who are using Hypothes.is in conjunction with Obsidian or other related note taking tools and publishing them to the web after-the-fact.

      Best, Chris Aldrich

    1. https://blog.jethro.dev/posts/taking_srs_seriously/

      And someone has actually built a spaced repetition system with Hypothesis! So it's not just me... 😄

    1. https://www.youtube.com/watch?v=9eP8Bq9x5yw

      A nice overview of spaced repetition systems.

      Soren Bjornstad previously worked for Anki and is now at Remnote.

      I wonder if anyone has created a spaced repetition system set up that leverages Hypothes.is? It would be cool to write questions and answers as one takes notes in Hypothes.is and then be able to quickly/easily export those annotations into a spaced repetition system.


      Q: What is the best annotation tool on the inernet?

      A: Hypothes.is

    1. Research shows that people who are asked to write on complex topics,instead of being allowed to talk and gesture about them, end up reasoning lessastutely and drawing fewer inferences.

      Should active reading, thinking, and annotating also include making gestures as a means of providing more clear reasoning, and drawing better inferences from one's material?

      Would gestural movements with a hand or physical writing be helpful in annotation over digital annotation using typing as an input? Is this related to the anecdotal evidence/research of handwriting being a better method of note taking over typing?

      Could products like Hypothes.is or Diigo benefit from the use of digital pens on screens as a means of improving learning over using a mouse and a keyboard to highlight and annotate?

    1. Nice to see someone speaking so joyously about annotations. :) Looks like you've got a heavier analog version of the digital version of what I'm doing. I often use Kindle hightlights/annotations and then import them to Obsidian. Alternately I use Hypothes.is on online .pdf copies and then use Hypothesidian (https://forum.obsidian.md/t/retrieve-annotations-for-hypothes-is-via-templater-plugin-hypothes-idian/17225) to import all my digital notes into Obsidian. I love being able to keep the original context of the text close for either creating literature notes or expanding fleeting notes into permanent ones. When I am in a more analog mode (who doesn't love the feel of a nice fountain pen on paper?) I have a method for doing optical character recognition on my handwritten notes to save the time of typing them out again: https://boffosocko.com/2021/12/20/55799844/

    1. And it’s easier to share a personal story when you’re composing it 280 characters at a time and publishing it as you go, without thinking about or knowing where the end may be. It’s at least easier than staring down a blank text editor with no limit and having to decide later how much of a 2,500 word rant is worth sharing, anyway.

      Ideas fill their spaces.

      When writing it can be daunting to see a long blank screen and feel like you've got to fill it up with ideas de novo.

      From the other perspective if you're starting with a smaller space like a Twitter input box or index card you may find that you write too much and require the ability to edit things down to fit the sparse space.

      I do quite like the small space provided by Hypothes.is which has the ability to expand and scroll as you write so that it has the Goldilocks feel of not too small, not too big, but "just right".

      Micro.blog has a feature that starts with a box that can grow with the content. Once going past 280 characters it also adds an optional input box to give the post a title if one wants it to be an article rather than a simple note.

      Link to idea of Occamy from the movie Fantastic Beasts and Where to Find Them that can grow or shrink to fit the available space: https://harrypotter.fandom.com/wiki/Occamy

    1. That would put these great conversations as starting points into our private notes, and put selected private thoughts (and better incentives) into our conversations

      Worth considering why these private notes are not first-class Hypothes.is annotations already (even if not marked public)!

  8. Feb 2022
    1. urn:x-pdf:a08d875ad57045edf70d283087a0e339 (PDF fingerprint)

      To find this urn address for your .pdf files and their fingerprints (particularly local/private files not otherwise hosted in the cloud):

      1. Visit https://jonudell.info/h/facet/
      2. Search for your Hypothes.is username (and perhaps a tag) to find the document name and annotations you made on it.
      3. You should be able to click on the document title which will take you to a non-loading web page with an address that looks something like this: urn:x-pdf:1ab23cd45e678fgh9012i34j56k78l90

      If others know of alternate/faster methods of finding URIs for local pdf files I'd be happy to hear about them.

    1. pupka12Dec '21Does anyone know a way to do this with my annotations on locally stored pdfs? That would be lovely. I know I could probably move them to some cloud, but I have no idea which one could work (the most popular ones seem not to)

      If you've annotated local (private) files within your browser using Hypothes.is, you'll need to find the uri path (a rough equivalent to http address for web pages) for your .pdf file with its "fingerprint" (a long unique number).

      To do this 1. Visit https://jonudell.info/h/facet/ 2. Search for your Hypothes.is username (and perhaps a tag) to find the document name and annotations you made on it. 3. You should be able to click on the document title which will take you to a non-loading web page with an address that looks something like this: urn:x-pdf:1ab23cd45e678fgh9012i34j56k78l90 4. Copy and paste that address you get into Hypothesidian as the address for an appropriate option like "Retrieve my annotations for a web article or web pdf". 5. Hit enter/return. 6. Hypothesidian should return the appropriate annotations for that document.

      If others know of alternate/faster methods of finding URis for local pdf files I'd be happy to hear about them.

    1. Suppose the server were sending rel=canonical in a Link header for non-document resources (e.g. images like this one). Is the Hypothesis bookmarklet/extension thorough enough to deal with this?

  9. Jan 2022
    1. ... meaning I'm not within any form of an LMS. I've beaten the drum for some time about the use of Hypo. outside of an LMS environment (e.g., I edit and give gratis feedback on PDF articles posted to Academia.com, etc.). Anyone out there who's also "adrift" in this non-remunerative (from Hypo's point of view) area who also finds Hypo. a worthwhile aid in their individual endeavors?  Maybe we could/should form a separate thread for Hypo. users outside of the LMS world?And I'll explain my weird handle to you in the process...hint: it's because I thought Hypothes.is was actually Iceland-based... ;)J.

      Hakarlfresser, There are definitely a bunch of us (non-LMSers) floating around who you'll slowly see in the margins. It may take some time and effort to find your tribe, but it's doable. I think the biggest group I've run across was as a result of iAnnotate 2021, and in particular the note taking session: https://iannotate.org/2021/program/panel_font.html. Looking at the annotations on the iAnnotate site will uncover a few of us. If it helps, I list a few of the feeds of others that I'm following here: https://boffosocko.com/about/following/#Hypothesis%20Feeds

      Best, Chris https://hypothes.is/users/ChrisAldrich

    1. You could imagine employers shipping corporate laptops with pre-installed notes to make it easier to transfer (previously tacit) knowledge and thus improve the onboarding process for new hires.

      Using Hypothes.is as an annotation layer for internal company notes in a private space could be an interesting way for easing on-boarding.

      In some sense, this is a little bit of what the annotated syllabus is doing for students at the beginning of a course (in addition to helping to onboard them to the idea of social annotation at the same time.)

    2. Why isn’t there a digital note taking tool that works like this?

      It would be interesting if there were a timed pop-up notification functionality within Hypothes.is directly so that one could create follow-up reminders for particular highlights and annotations.

      I've thought about wanting this before though I've got something in my data store for those notes that does something like this in a third-party sense.

    3. You could write down notes like this in a separate notebook, but then you’d lose the connection to the source they are based on. What makes post-it notes so interesting is the spatial relationship between the notes and their respective context.

      Sticky notes or Post-It notes create a physical and spatial relationship between the note and its context. This same sort of relationship is recreated by taking notes in Hypothes.is which links the note or idea directly to the part of the web page or document which spurred it. Moving these notes into other platforms (Roam Research, Obsidian, etc.) can be done in a way so as to keep the physical link (using URLs) so that one can quickly and easily revisit the original context if necessary.

      This affordance is an incredibly useful one which is generally neglected in the note taking space.

      How often in practice is this done though?

  10. Dec 2021
    1. Annotates: { "license": "https://creativecommons.org/publicdomain/zero/1.0/", "obj_id": "https://doi.org/10.1007/bfb0105342", "source_token": "8075957f-e0da-405f-9eee-7f35519d7c4c", "occurred_at": "2015-11-04T06:30:10Z", "subj_id": "https://hypothes.is/a/NrIw4KlKTwa7MzbTrMAyjw", "id": "00044ac9-d729-4d3f-a2c8-618bcdf1d252", "evidence_record": "https://evidence.eventdata.crossref.org/evidence/20170412-hypothesis-de560308-e500-4c55-ba28-799d7b272039", "terms": "https://doi.org/10.13003/CED-terms-of-use", "action": "add", "subj": { "pid": "https://hypothes.is/a/NrIw4KlKTwa7MzbTrMAyjw", "json-url": "https://hypothes.is/api/annotations/NrIw4KlKTwa7MzbTrMAyjw", "url": "https://hyp.is/NrIw4KlKTwa7MzbTrMAyjw/arxiv.org/abs/quant-ph/9803052", "type": "annotation", "title": "[This article](http://arxiv.org/abs/quant-ph/9803052) was referenced by [\"Decoherence\"](http://web.mit.edu/redingtn/www/netadv/Xdecoherenc.html) on Sunday, September 25 2005.", "issued": "2015-11-04T06:30:10Z" }, "source_id": "hypothesis", "obj": { "pid": "https://doi.org/10.1007/bfb0105342", "url": "http://arxiv.org/abs/quant-ph/9803052" }, "timestamp": "2017-04-12T07:16:20Z", "relation_type_id": "annotates" }
      • An arXiv page (article with DOI) is considered OBJECT (DOI)
      • This example is an AUTO-REFERENCE !!!

      • It is due to the arXiv Agent (?)

    2. The Hypothes.is Agent monitors annotations
      • See examples of Evidences
      • Agent uses "url": "https://hypothes.is/api/search"
      • GUESS: filter by date of annotation? "extra": { "cutoff-date": "2005-04-13T09:08:04.578Z"
    1. Using this idea, it is easy to include some javascript generated by a server-side process (eg. JSON object). var e = document.createElement("script"); e.src = 'http://myserver.com/servlet/getfeed?url=http://realhowto.blogspot.com'; e.type="text/javascript"; document.getElementsByTagName("head")[0].appendChild(e);
      • IDEA: probar con hlib
    1. In addition to facet, other tools based on this library include CopyAnnotations and TagRename
      • SEE
    2. A JavaScript wrapper for the Hypothesis API The HelloWorldAnnotated example uses functions from a library, hlib, to post an annotation to the Hypothesis service.
      • AT LAST!
      • SEE
    1. SciBot Link: https://github.com/SciCrunch/scibot Description: This tool finds RRIDs in articles, looks them up in the SciCrunch resolver and creates Hypothesis annotations that anchor to the RRIDs and display lookup results. More info here.