For reviewers — annotating with Hypothes.is¶
This site embeds the Hypothes.is open-source W3C Web-Annotation client on every page. You can:
- Highlight any text and leave a comment, question, or correction.
- Reply to existing annotations in a threaded conversation.
- Tag annotations so the maintainers can triage them (e.g.
#sourcing,#units,#math).
How to open the sidebar¶
Look at the right edge of the viewport — there are three small icons stacked vertically:
| Icon | Action |
|---|---|
| < (chevron) | Open / close the annotation sidebar |
| Speech-bubble | List all annotations on this page |
| Highlighter | Toggle highlight overlay |
Sign-in is via hypothes.is — free, takes 30 s. Without a sign-in you can still read other people's annotations, just not add your own.
Scope of annotations¶
For this prototype, annotations are kept in the public Hypothes.is
group. Once we move to the production deployment, the embed in
overrides/main.html will be updated with a "groupsAllowlist": [...]
entry that restricts visibility to the ACAP reviewer group only — same
mechanism as the ACAP aerospace-processes site.
A few useful starting points¶
- The made-up CF values on the Impact assessment page are the obvious thing to question. Annotate the cell and propose a source.
- The equations on the Methodology page are reproduced in plain LaTeX so they can be highlighted character by character — useful if you spot a sign error or a missing factor.
- The figures on the Figures page do not yet have uncertainty bands. If you think they should, file an annotation on the relevant section header.