Tag: Hypothesis

I am Open (and so can you!)

The book cover for Stephen Colbert's book I am America and so Can YouFor the next few weeks, I will be taking a history course, something I thought I would never do again after I finished my dissertation. Shawn Graham is teaching an online digital history course at Carleton University and has opened it up for non-matriculating students.

The entire design of the course is fantastic for open learners. Rather than just allowing us to watch from the rafters, Shawn has set up a Slack team and is active in the channels. Shawn asks that students blog for the course and use github to keep a record of their progress in the coding exercises. The course readings are all openly accessible and Shawn has asked that the students use Hypothes.is so that their reading notes are open (you can find them in the Hypothes.is stream with the tag hist3814o).

For the first week, Shawn has assigned a set of readings on the concept of open notes research within history and the humanities more broadly. Open notes research is more commonly practiced in the sciences. Jean Claude-Bradley was advocating for the concept in chemistry as early as 2006. Open notes science improves reproducibility and verifiability of results, and it also opens up the vast array of information that is gained during research but never published.

Open notes research has been slow to catch on, and it doesn’t take long to brainstorm possible objections. Publications are the coin of the realm in academia, and sharing your research notes could possibly allow someone to scoop your ideas. However, I agree with the readings that Shawn has curated and his push during this week of the course that open notes research is the best practice. Clearly, as I am writing this blog, I feel that sharing my thought processes helps me to clarify my thoughts and develop my understanding of my research. Sharing our reading notes with Hypothes.is and collecting our code in GitHub take this a step further. We’re thinking, reading, and experimenting (coding) out loud.

I am taking Shawn’s course, because I want to see how he uses Slack, and because I think the course design is fantastic. I’m already a convert for open notes research and have blogged about it repeatedly hereherehere and in many other posts. This site as a whole is an argument for open notes research and the related ideas of getting rid of disposable assignments and empowering students to contribute to a broader knowledge community. However, I did enjoy the week’s readings, especially Caleb McDaniel’s post that turned me on to open notes research a few years ago. I look forward to joining in for the exercises next week (this week everyone was learning MarkDown and Git). Most of all, I want to encourage any readers in the ed tech world who have not taken a digital history or digital humanities course to at least poke around Shawn’s course to see the wonderful overlap between that knowledge domain and the current ed tech focus on digital literacy and citizenship.

My Week in Review May 16 – 20

Tweet of the Week

Blog Writing

– On Wednesday, I put up a post about a Google Spreadsheet that I’ve built called Hypothes.is Collector. The basic idea is that you can use the Google sheet to search through the annotations made using the Hypothes.is web annotation tool. You can enter various search terms like user name or url or tag or pull all annotations by a group. The system will create a google sheet with up to 200 annotations (working to increase this right now), and create a table that counts the number of annotations by user across various urls. This last piece was the initial reason for the project. I wanted to build a tool that allowed instructors to quickly see the activity of their students in a group. It could similarly be used by a research group or anyone else. Both the sheet and the code are open, so please read the blog post or check out the sheet itself.



– This week has been quiet. I’ve been working with Keegan Long Wheeler on our GOBLIN project, and I’m meeting today with Lauren Horn Griffin to finalize plans for a workshop we’re doing next week on using Hypothes.is in the classroom.


– The OU Spring semester ended on Sunday, so I spent all of Monday and Tuesday calculating and entering grades and working with students to find those missing assignments that meant the difference between a C and a B. Hitting submit on Tuesday provided a definite sense of closure on the semester.

– There was supposed to be an 8-week summer version of one of the courses that I facilitate kicking off this week. However, we had to cancel it due to low enrollment. The online course is heavily discussion based and we didn’t think the handful of students enrolled would have a good experience in the course. As late as last week I was reviewing the course contents making sure the materials were all properly titled and tagged in our LMS and fixing several broken image and web links.  Thursday I found out that the course was being cancelled.  Rather than finishing my review of the last couple of units, I talked to the professor and then contacted the students. I then contacted the registrar’s office, our LMS support people, the office that helps concurrent enrollment students, the TAs, etc. Working with a professor to design a class is an extended process, and I had lost track of how many people were involved.  Cancelling the class required that I email or call all of these people in a couple of hours. This week I’ve been finishing the clean up and helping to either get students refunds or move into the June or Fall versions of the class. Next week, I’ll do the QA on the June class and start back into the course management cycle anew.

OU Create Maintenance

– Minor upkeep helping students activate new accounts and helping faculty transition from their old html only sites into their new LAMP domains.

Reading and Viewing and Gaming

– I have watched a ton of basketball lately. As an OKC fan, it’s been an up and down week, and I’m looking forward to Sunday.


– I have been painting (enamel + polycrylic) my kitchen cabinets all week, and it looks like I’ll be working on them for at least another week. Before and after pictures to come.

Hypothes.is Collector

One of my favorite online tools is Hypothes.is. It allows you to annotate web pages as you would a book. When you’re using Hypothes.is you can highlight text on a webpage or add notes.

The tool can be used to take private notes, but it becomes all the more powerful when you use it for collaborative reading. By making your notes public or sharing them with a chosen group, you can share your take on a reading as you’re reading it. My colleague Lauren Horn Griffin recently wrote on the uses cases for this web annotation within a university setting. She identified five possibilities

  • Reading Accountability & Promoting Active Reading
  • Collaborative Reading & Modeling
  • Public-but-Independent Research
  • Instructor Feedback/Self-Assessment
  • Citations

You can launch the tool by appending “https://via.hypothes.is/” before a URL. To annotate this post you would visit https://via.hypothes.is/http://www.johnastewart.org/tools/hypothes-is-collector/. You can also download an extension for Chrome to be able to launch Hypothesis quickly on any website. Site builders can also install Hypothes.is directly into WordPress, Drupal, or Jekyll sites, or pretty much anything else that allows javascript.

Here is how a recent LA Review of Books article on Digital Humanities looks when viewing the public annotations:

A screenshot of an article in LA Review of Books on Digital Humanities with the Hypothesis tool active

Hypothes.is Collector

In order to make it easier to track activity in Hypothes.is, I created a program called Hypothes.is Collector. The idea is that you can type in user name, a URL, a tag, or a group ID and click the button to see all of the related annotations. The program will create a new sheet with an archive of up to 200 annotations based on the search terms.  It will then create a third sheet that will count how many of these annotations were made on each URL in the set by each user.


As with Hypothes.is itself, I see several use cases for this. The original idea for the program was to allow a course instructor to quickly see the activity of their students. If an instructor asks her students to annotate three different articles, she could use this app to assess whether or not each student made their annotations. The easiest way to do this would be to set up a group in Hypothes.is for the class.  The instructor could then enter the group ID and her user authorization token (a unique password that allows you to pull your private and group annotations) into the system. When she clicked the button, she would see an archive of the annotations and a count of activity for the students across the three readings.

Other use cases as I currently see them include:

  • Studying how various tags are being used within Hypothes.is
  • Tracking recent public activity for Hypothes.is
  • Breaking down activity on a particular reading by user
  • Tracking one of Remi Holden’s  annotation flash mobs

I built the Collector as an attempt to make it easy for people to access annotations in a format that could then be analyzed. I think the counter that gets built on the third sheet is handy, but it’s not going to be useful for everyone. As I continue to refine this project, I am going to add some different visualizations of the annotation archive and I will extend the number of annotations that can be pulled at a single time. I welcome feedback and feature requests and encourage everyone to modify the project to best suit their needs.

Please try out the new Hypothes.is Collector. You can follow this link to get a copy of the spreadsheet and collect annotations. You can also view or modify the code by choosing “Script Editor” from the Tools Menu.


A few notes on the Code:

The code for the program (shared below) is written in Google Scripts. This is a modified javascript that features a library of functions to facilitate interaction within and between the Google Docs Apps. While writing this particular code, I learned a few tricks for collecting and passing the parameters for the API search and how to pass the authorization token. You can run Google’s version of a GET request, UrlFetchApp.fetch, woith or without an authorization token and other advanced options. To run it with the advanced options (to pass headers like authorization), I formatted the ‘headers’ as a js object, passed them into a second object called ‘options’, and then passed ‘options’ a parameter into UrlFetchApp.fetch.

This probably isn’t interesting to most people, but it took me a long time to figure out and opens the doors to all sorts of other APIs that require authorization. Google Script is a little particular and APIs vary, but I learned a lot about APIs while figuring out the authorization, search parameters, and how to parse the returned json. After writing an initial version of the code, I found better solutions to many of my questions in some of Jon Udell’s Hypothes.is API code – so thank you Jon and be sure to check out his site: jonudell.net.

The bit of code at the end that sets up the third spreadsheet for counting annotations by user and URL is also pretty nifty. I had to figure out how to use arrays to populate Sheets ranges and then played with the archaic R1C1 notation to create dynamic formulas for the sheet. Feel free to hack at or extend the code for your own use. Chunks of the code may also be useful for working on other API projects. As with most of my work, feel free to take whatever is useful.

End of code

Powered by WordPress & Theme by Anders Norén