How multi-URLs and cross-format annotation works in Annotopia

Dear all,
Just to make the discussion more concrete I wanted to explain what I
implemented in Annotopia to support  multiple URLs and cross-format
annotation. This should clarify why, in my head, this is both a matter of
model and of protocol.

Annotopia can serve multiple clients:
- if I have a client that extracts/understand IDs (DOIs, PMIDs…) - like
Domeo and Utopia - the client can send the bibliographic information to the
server in the format explained here:
https://github.com/Annotopia/AtSmartStorage/wiki/Managing-Identifiers .
This is impacting the model.
- if I have a client that does not know how to handle IDs - example basic
Annotator.js -  it is perfectly fine. The server still offers an API option
where, even a basic client can ask for ‘target extended’ annotation. This
last feature impacts the protocol

‘Target extension’ is an option of the API that can be:
- off: the server returns only the annotations for a specific URLs
- on: the server returns the annotations for a specific URLs and then looks
up the tables of IDs and URLs mappings and returns also the annotations
that are related to alternative representations.

The API is here
https://github.com/Annotopia/AtSmartStorage/wiki/GET--annotation
and the parameter is named tgtExt.

How the IDs/URLs mapping tables are built can vary. But, if the client is
able to send in bibliographic data, I believe it should be able to do so as
an extensions to the Open Annotation format (again look at the above linked
wiki page).

As Nick (Stenning) said in a different email thread, these aspects don't
need to be necessarily part of the core model. However, bibliographic
information management is important and, at least, I would think of
providing guidance so that we can understand each other.

Hope this helps the conversation around the multi-URLs and Cross-format
annotation use case (
https://www.w3.org/annotation/wiki/Cross-formats_Annotations).

Best,
Paolo

-- 
Dr. Paolo Ciccarese
Assistant Professor of Neurology, Harvard Medical School
Assistant in Neuroscience, Massachusetts General Hospital
Senior Information Scientist, MGH Biomedical Informatics Core
ORCID: http://orcid.org/0000-0002-5156-2703

CONFIDENTIALITY NOTICE: This message is intended only for the addressee(s),
may contain information that is considered
to be sensitive or confidential and may not be forwarded or disclosed to
any other party without the permission of the sender.
If you have received this message in error, please notify the sender
immediately.