This presentation was provided by Heather Staines of Hypothesis during the NISO Webinar, Annotation: Practices and Tools in a Digital Environment, held on January 10, 2018.

1. Open Source
Standards-based Annotation
Heather Staines
10 January 2018

2. A mission-driven non-profit
Early Momentum
Open Standards
Supported by Partners
Open SourceBetter Team Layers Better Go-to-Market
More Users Independent
W3C-SupportedBetter ApproachMore CredibilityNo Conflicts
Free
ng Layered
12 Princi
Great Press More Focused Simp

3. Our Vision:
Universal Open
Source Annotation

4. Web Standard
On Feb 23, 2017 the W3C formally standardized
Web Annotations with unanimous ratification
by members.
w3.org/annotation
38 Active Working Group
Members
CSS
Web Annotations Working Group*
HTML
Web CSV
*Formal votes of support in October 2014

5. Annotating All Knowledge
Over 70 of the leading academic publishers, platforms and libraries are bringing
web annotation to the world’s scholarship over the next several years.
hypothes.is/annotating-all-knowledge

6. Community
Nurturing the annotation
community is one of the
most important things we do.
We’ve now hosted our fifth
annual I Annotate event --
bringing life to the W3
standards effort, the
Annotating All Knowledge
coalition, and countless
partnerships and
collaborations.

7. General Public
Mr. Johnson’s
Science Class
Expert
Community
Publisher
Notes
Built on open standards
Layers of annotation
Any Website, Article, eBook, Document, Multimedia

8. 2.4 Million Annotations and Counting

9. 19 Million User Sessions Around the World
Top 30 Countries by User Sessions: Jan 2015–Nov 2017

10. Annotation architecture: Use your own
server or own accounts
Annotate with a client on any
webpage, PDF, or EPUB
Authenticate with an
annotation server to
read/write annotations

11. Integrating Open
Source Annotation

12. Embedding Open Source Annotation
<script src="https://hypothes.is/embed.js" async></script>
● No cost
● Easy integration
● Includes all primary annotation capabilities

13. Plugins & integrations for embedding
● Canvas
● Drupal
● Omeka
● Open Journal Systems (OJS)
● WordPress
● Platform hosts (eg, Atypon, HighWire, Ingenta, PubFactory,
Silverchair)
See the full list of Hypothesis integrations and tools.

14. Configuring Hypothesis
Include a config tag above the the script tag. For example, the
following arrangement will ensure that highlights are hidden
by default:
<script type="application/json" class="js-hypothesis-config">
{"showHighlights": false}
</script>
<script src="https://hypothes.is/embed.js" async></script>
See the full list of configuration options in our
documentation.

15. Annotation dashboards
● For every user
and group
● Browse and
search for users,
tags, URLs, groups

16. Annotate anywhere
Major Digital Formats
● HTML
● PDF
● EPUB
● data
Document Equivalence (Aggregator sites and PubMed Central…)
Documents can be related to each other, eg:
● Canonical URLs
● DOIs
● PDF fingerprints

17. The Hypothesis API
What you can do with it (“API calls”):
● Read a single annotation
● Search for annotations for a URI, user, group, tag, text
● Create annotations
● Update annotations
● Delete annotations
● Utilize for Text and Data Mining
● Repurpose on your website
Documentation http://h.readthedocs.io/en/latest/api/
Genius example:
http://musically.com/2017/03/16/genius-pivots-towards-easy-consume-formats-like
-video/

18. Customized
Annotation

19. Custom, supported implementation
Everything in a basic implementation, and
● Assisted integration
● Single sign-on (if appropriate)
● Publisher branded and moderated groups
● UI customization
● Program to ensure successful rollout, training, and
outreach
● Support
● Open source maintenance

20. Publisher groups
● Publisher branded
● Configured to meet publisher needs, eg:
○ Limited/invited annotations: Publicly readable
○ “Anyone can join” annotations: Publicly readable
● Moderation
● Default visibility options

21. How is it being used?

22. Post-pub
Discussion
Colleague makes a
note on an arXiv
preprint that cites his
work.
Annotation used in
this way enables a
fundamentally new
kind of scientific
discourse.

23. Why should the
paper remain fixed in
time after publication
when it can be a
living document
instead?
Neuroscientist Elissa
Chesler annotates her
own paper to provide
updates and
additional
information.
Living
Research/
Preprints

24. Publisher &
Institutional Layers
Publishers,
corporations and
others can run their
own dedicated groups,
or even their own
entire server
infrastructure--
delivering annotations
into a common
universal client.

25. Peer Review
Using a combination
of group features,
permissions models
and copy-editing
workflows, a
high-fidelity
peer-review
capability can be
enabled.
Hypothesis has
conducted a first
integration with
eJournalPress.

26. Automated
Annotation of
Entities
Automated systems can
tag elements such as
RRIDs and other
scholarly identifiers or
entities, allowing
navigation to
background information
and powerful search
queries through other
papers mentioning the
same entity.

27. Illuminated
Footnotes
Footnotes, bibliographies
and other citations in texts
can be illuminated with
detailed information
linking directly to data and
other documents in
repositories.
Here, a citation is
annotated by the Syracuse
Qualitative Data
Repository.

28. Journal
Clubs
Annotation is perfect
for journal clubs.
Graduate students at
UT-Austin using
hypothes.is
embedded on
scholarly monograph
at University of
Michigan Press (note
professor replying to
student annotation)

29. climatefeedback.org
Holding the media accountable
Contributors
per Feedback
“Feedbacks”
Created
Approved
Reviewers
180+ 5+50+

30. The
Classroom
Annotation is
perfect for
blended learning
environments.
Primary source
historical
documents
annotated in an
online course.

31. Other uses:
● Production teams working with vendors to annotate
xml staging site
● Making notes on journal landing pages for title
migration
● Editorial and Sales sharing notes on authors
● Marking up invoices/data with questions
● What will you try?

32. Questions and answers
Contact us to learn more:
heather@hypothes.is
hypothes.is/publishing