The @mentions feature allows users to mention specific users of the Hypothesis web app and make sure those users receive a notification of the mention.
How do @mentions work?
To mention a user in an annotation, type “@” followed by their username. A list of suggested users will appear as you type. You can select a user by clicking their name or using the arrow keys and pressing Enter/Return. Alternatively, you can type “@” followed by their username to mention a specific user. Once done, write your annotation and click Post to to save it and officially mention the user.
Note:
- The suggested usernames will change as you continue to type the username.
- Suggested usernames can be based off of group membership and who’s recently annotated the text in the group.
- A user can only mention users who are part of the group.
After saving an annotation, a mentioned user appears as a hyperlink.
Hovering over the link shows a pop-up with the user’s username, display name, and join date.
Clicking the link opens the Hypothesis Activity Page, displaying the mentioned user’s activity.
If the mentioned user is not part of the group or does not exist, the pop-up will indicate that the user does not exist.
Notifications
When a user is mentioned in an annotation, they will instantly receive an email notification about the mention in a specific text.
In the email notification, clicking the View Activity button will show the annotation within the context of the annotated text. At the bottom of the email, you’ll find links to update your email preferences or unsubscribe. If ever you unsubscribe, you can always subscribe back by going to your Hypothesis Account Settings > Notifications.