Join GitHub today
GitHub is home to over 40 million developers working together to host and review code, manage projects, and build software together.Sign up
evaluate addition of referencePublication field #277
While there may be support for this proposal, it raises issues:
If this were desired, I would consider an implementation such as:
<xs:element name="referencePublication" type="cit:CitationType" minOccurs="0" maxOccurs="unbounded"> <xs:annotation> <xs:appinfo> <doc:tooltip>Reference Publication</doc:tooltip> <doc:summary>A citation to an additional publication that serves as an important reference for a dataset.</doc:summary> <doc:description>AA citation to an additional publication that serves as an important reference for a dataset. People using this dataset should generally cite the dataset itself (using the creator, pubDate, title, publisher, and packageId fields), and consider providing an additional citation to the Reference Publication. </doc:description> </xs:appinfo> </xs:annotation> </xs:element>
referencePublication would work, if it’s intended to be used like ‘reference implementation’, i.e., the paper illustrates the usage of this dataset.
For data papers, this would lead someone to the research paper that accompanied the dataset (if they reached the dataset by some pathway that did not include the paper) -- which is good - they are cases where they should be cited together.
But I think it is too strong a statement to say that users should “consider citing the paper” too. I can see plenty of cases where a reference publication are not be as tightly coupled as a research paper + data paper. ;
The example has wording for both (doc:summary, doc:description)
These include a new ability to use Bibtex citation format both within the `citation` element, and within a new `bibtex` element, to create lists of refs using these in a literatureCited element (#300), as well as in usageCitation (#259), and referencePublication (#277) elements. All of this helps support data papers (#269), for which pandoc-style citation keys can be used to cite these references in the text of Markdown blocks in the EML document. Added these features as demonstrations in the eml-data-paper.xml sample document.