sssom icon indicating copy to clipboard operation
sssom copied to clipboard

Clarifying the roles of individuals involved in the maintenance of mappings (within reason)

Open matentzn opened this issue 2 years ago • 5 comments

After discussions with @NuriaQueralt, its clear we need to distinction a few more roles than just "creator".

  • creator: first agent to assert the mapping
  • publisher: the group/individual that publishes the mappings (i.e. Monarch Initiative, Gene Ontology Consortium)
  • curator: the reviewer of the mapping, the person that actually looked at it and deemed it "good" (think OxO user review use case)
  • contributor: any agent that contributes to the creation or review of the mapping that is not one of the above.

Does this make sense?

matentzn avatar Jul 21 '21 16:07 matentzn

You may want to consider if you want to distinguish between the person who asserted the mapping and the person who represented it in SSSOM.

PAV does this with

  • author the agent that asserted the mapping
  • creator the agent that put it into its published form

AlasdairGray avatar Jul 21 '21 16:07 AlasdairGray

PAV is a good resource for clarifying the roles, thank you @AlasdairGray !

matentzn avatar Jul 22 '21 08:07 matentzn

Another resource to consider is Contributor Role Ontology (CRO): https://data2health.github.io/contributor-role-ontology/ cc @mbrush

matentzn avatar Sep 02 '21 09:09 matentzn

For the first version, we will probably go with @AlasdairGray's suggestion. We map the author to pav, but because of historical reasons continue to map the creator to dc:creator. We also add a new category of reviewer:

creator_id:
    description: Identifies the persons or groups responsible for the creation of
      the mapping. The creator is the agent that put the mapping in its published form, 
      which may be different from the author, which is a person that was actively involved
      in the assertion of the mapping.
      Recommended to be a (pipe-separated) list of ORCIDs or otherwise
      identifying URLs, but any identifying string (such as name and affiliation)
      is permissible.
    slot_uri: dc:creator
    range: uriorcurie
    multivalued: true
  creator_label:
    description: A string identifying the creator of this mapping. In the spirit of
      provenance, consider to use creator_id instead.
    range: string
    multivalued: true
  author_id:
    description: Identifies the persons or groups responsible for asserting the mappings.
      Recommended to be a (pipe-separated) list of ORCIDs or otherwise
      identifying URLs, but any identifying string (such as name and affiliation)
      is permissible.
    slot_uri: pav:authoredBy
    range: uriorcurie
    multivalued: true
  author_label:
    description: A string identifying the author of this mapping. In the spirit of
      provenance, consider to use author_id instead.
    range: string
    multivalued: true
  reviewer_id:
    description: Identifies the persons or groups that reviewed and confirmed the mapping.
      Recommended to be a (pipe-separated) list of ORCIDs or otherwise
      identifying URLs, but any identifying string (such as name and affiliation)
      is permissible.
    range: uriorcurie
    multivalued: true
  reviewer_label:
    description: A string identifying the reviewer of this mapping. In the spirit of
      provenance, consider to use author_id instead.
    range: string
    multivalued: true

matentzn avatar Sep 27 '21 16:09 matentzn

Should we suggest reviewer as a new property in PAV?

AlasdairGray avatar Sep 28 '21 08:09 AlasdairGray