Type of People in the Person Group
Role of the persons being named in <person-group> element (for example, authors, editors, members of the G&S chorus).
Attribute Contents: The @person-group-type attribute was designed to name the role of the contributor and was also designed to accept any text as its value. Values may be from a controlled vocabulary such as CRediT (“Data Curation”), natural language words such as such as “author” or “deep sea diver”, or terms previously used in the JATS Tag Sets for the @person-group-type attributes (“all-authors”, “assignee”, “compiler”, “director”, etc.).
Best Practice: When to Use @person-group-type: If the @person-group-type value is from a controlled vocabulary, such as CRediT, Best Practice is not to use @person-group-type to name the role. Best Practice (when possible) is to tag the CRediT taxonomy of contributor roles by using the <role> element inside <person-group>. The major advantages of using <role> instead of @person-group-type are
- The ability to tie the content of the role to a formal vocabulary using the four JATS vocabulary attributes, and
- the ability for a contributor to play more than one role in the creation of an article.
Roles defined by the CRediT Taxonomy might include, for example, “Conceptualization” (Ideas; formulation or evolution of overarching research goals and aims.), “Data curation” (Management activities to annotate [produce metadata], scrub data and maintain research data [including software code, where it is necessary for interpreting the data itself] for initial use and later reuse.), or “Writing – original draft” (Creation and/or presentation of the published work, specifically writing the initial draft.)
In the pre-CRediT days, the @person-group-type value had the following suggested values, which JATS users not choosing to align with CRediT may prefer instead, and which will certainly be seen in older documents:
Used to identify a complete list of authors when a subset of the author group is used elsewhere in the citation. This may occur, for example, when a citation identifies both a book and a chapter within the book.
Persons to whom a patent is awarded
Persons who put together a composite work from multiple sources
Person or group responsible for data curation or archival curation
Content editors that have been invited to edit all or part of a work
Creator of the pictures, drawings, or other illustrations (includes photographer)
Idea, software, or machine creators
Assisted with the scientific research that is the basis for a work
Editors of a translated version of a work
Persons who translated the cited work from one language into another
Used on Element: <person-group>
|Text, numbers, or special characters||The role played by the person group in the creation/production of the article, for example, “editors” or “research assistants”.|
|Restriction||@person-group-type is an optional attribute; there is no default.|
... <person-group person-group-type="author"> <name><surname>Lawrence</surname> <given-names>Ruth A</given-names></name> </person-group> ...
Using @person-group-type as well as the <role> element, which describes the function of the contributor using a CRediT taxonomy term:
... <ref> <mixed-citation publisher-type="gov"> <person-group person-group-type="author"> <string-name><surname>Norman</surname>, <given-names>John C</given-names></string-name> (<role vocab="CRediT" vocab-identifier="http://dictionary.casrai.org/Contributor_Roles" vocab-term="Writing - Original Draft" vocab-term-identifier="http://dictionary.casrai.org/Contributor_Roles/Writing_%E2%80%93_original_draft" >sole author</role>) <aff>Texas Heart Institute, Houston, TX</aff> </person-group>. <gov>Report No.: NIH-N01-HV-5-3006-4-VI. Contract No. N01-HV-5-3006</gov>. <source>ALVAD: 1980. A comprehensive final report to NHLI</source>. Vol. <volume>1</volume>.... </mixed-citation> </ref>...