Table 2.
Software Citation Use Cases—Software Citation with Software Heritage Persistent Identifier (PID) & Software Citation with other PID.
Use Case Name, Description | Desired Outcome for JATS XML version 1.3 | Desired Outcome for Crossref Metadata depository schema 5.3.1 | Notes |
---|---|---|---|
Use Case C Software Citation with Software Heritage Persistent Identifier (PID) A registered PID has the desired metadata to support this citation and allows for content negotiation. |
<ref id=“bib2”> <element-citation publication-type=“software”> <person-group person-group-type=“author”> <name> <surname> Zhang </surname> <given-names> Martin </given-names> </name> </person-group> <year iso-8601-date=“2021”>2021</year> <part-title> tabula-muris-senis </part-title> <source> Software Heritage </source> <pub-id pub-id-type=“swhid”> swh:1:dir:7dc782970300a97e9bca9038ba34728c857a0638 </pub-id> </element-citation> </ref> |
Tag: //citation/unstructured_citation e.g. <citation key=“XXX”> <unstructured_citation> Zhang Martin 2021, tabula-muris-senis, Software Heritage,swh:1:dir:7dc782970300a97e9bca9038ba34728c857a0638 </unstructured_citation> </citation> |
Con: Non-DOI PIDS are typically not converted to clickable links on journal websites and some journals encourage use of a URL as a preference. |
Use Case D Software Citation with other PID (e.g., RRID (Research Resource Identification), ARKs (Archival Resource Key, https://registry.identifiers.org/registry/ark), Handle, ASCL (Astrophysics Source Code Library, https://registry.identifiers.org/registry/ascl), SwMathID), A PID is used for the software but is not a DOI. |
<ref id=“bib2”> <element-citation publication-type=“software”> <person-group person-group-type=“author”> <collab> Broad Institute </collab> </person-group> <part-title> CellProfiler Image Analysis Software </part-title> <pub-id pub-id-type=“rrid”>SCR_007358</pub-id> </element-citation> </ref> |
Tag: //citation/unstructured_citation e.g. <citation key=“XXX”> <unstructured_citation> Broad Institute, CellProfiler Image Analysis Software,SCR_007358 </unstructured_citation> </citation> |
Con: Non-DOI PIDS are typically not converted to clickable links on journal websites. |