Version and Change Log

Table 1. Version
Type	Version Number
Documentation	v1.4
Schematron	v1.4

Table 2. Change Log
Date	Release	Changes
09/06/2025	v1.4	Documentation Changes Corridor (AAS) - Updated to add Planetary Science as a new AAS Corridor. CRediT – Contributor Role Taxonomy - New topic to cover capture instructions for Contributor Role Taxonomy terms. Supplementary Data (DOIs) - New topic to cover instructions for supplementary data files with DOIs. Supplementary Data (AAS) - New topic to cover instructions for AAS articles with supplementary data files with DOIs. Validation Changes jats-1.3-rule-015 - Updated to add Planetary Science as an allowed value for AAS Corridors. jats-1.3-rule-076 - Updated to allow arxivppt as a value in `<custom-meta>` elements to capture arXiv preprint identifiers. jats-1.3-rule-137 - New rule to validate that child `<object-id>` elements of `<supplementary-material>` have a `@pub-id-type` attribute with the value doi. jats-1.3-rule-138 - New rule to validate the format of the doi in `<object-id>` elements. jats-1.3-rule-139 - New rule to validate the presence of non-empty `@content-type`, `@id` and `@xlink:href` for supplementary data DOIs. jats-1.3-rule-140 - New rule to validate the presence of a non empty `<label>` element for supplementary data DOIs. jats-1.3-rule-141 - New rule to validate the presence of a non empty `<caption>` element for supplementary data DOIs. jats-1.3-rule-142 - New rule to validate the presence of a non empty `<permissions>` element for supplementary data DOIs. jats-1.3-rule-143 - New rule to validate the presence of a non empty `<copyright-statement>` element for supplementary data DOIs. jats-1.3-rule-144 - New rule to validate the presence of a non empty `<copyright-year>` element for supplementary data DOIs. jats-1.3-rule-145 - New rule to validate the presence of a non empty `<license>` element and related attributes for supplementary data DOIs. jats-1.3-rule-146- New rule to validate the presence of a non empty `<license-p>` element for supplementary data DOIs. jats-1.3-rule-147 - New rule to validate `<supplementary-material>` elements have the correct `@content-type` for AAS Data DOIs. jats-1.3-rule-148 - New rule to validate `<supplementary-material>` elements for AAS Data DOIs have a non-empty child `<object-id>` element. jats-1.3-rule-149 - New rule to validate `<supplementary-material>` elements for AAS Data DOIs have a non empty child `<graphic>` element. jats-1.3-rule-150 - New rule to validate `<supplementary-material>` elements for AAS Data DOIs have a non-empty child `<xref>` element. jats-1.3-rule-151 - New rule to validate that `<role>` is only allowed as a child of `<contrib>` elements. jats-1.3-rule-152 - New rule to validate the correct values for `@vocab` and `@vocab-identifier` attributes on `<role>` elements. jats-1.3-rule-153 - New rule to validate that `@degree-contribution` attributes on `<role>` elements have values from the allowed list. jats-1.3-rule-154 - New rule to validate that the `@vocab-term-identifier` attribute on `<role>` elements have values from the allowed list. jats-1.3-rule-155 - New rule to validate that the `@vocab-term` attribute on `<role>` elements match the `@vocab-term-identifier`. jats-1.3-rule-156 - New rule to validate that `<role>` elements must have a `@vocab-term attribute` with same value as text content of the node. jats-1.3-rule-157 - New rule to validate that a single `<contrib>` cannot have multiple `<role>` elements of the same type. jats-1.3-rule-158 - New rule to disallow the use of `<attrib>` elements as children of `<fig>`/`<caption>`. Sample & Example File Changes All articles updated to validate against the new validation rules.
31/03/2025	v1.3	Documentation Changes Author and Editors - Updated to note that authors with only one name should be captured in a `<surname>` element. Figures - Updated to note that `<fig>` may have up to three `@content-type` attributes for `<graphic>` as opposed to all three being required. Instruction added Figures - Updated to clarify that a `<graphic>` element with `@content-type` attribute with the value online is required for each `<fig>` element. Online Publication Date - Updated to indicate the five journals that do not use online publication dates. Self URI (PDF) - Updated to clarify that Research Notes of the AAS does not use PDF files and is excluded from this topic. Validation Changes jats-1.3-rule-028 - Updated to give a warning if the contributor has no `<given-names>` element. jats-1.3-rule-032 - Updated to exclude the five journals which do not contain a `<pub-date>` with `@pub-type` attribute of value epub. jats-1.3-rule-053 - Updated to exclude Research Notes of the AAS from the rule. jats-1.3-rule-056 - Rule deprecated for this release. jats-1.3-rule-070 - Rule deprecated for this release. jats-1.3-rule-080 - Scope changed to only check `<fig>` has a `@content-type` attribute with value online. Changed from a warning to an error. jats-1.3-rule-099 - Rule deprecated for this release. All the tests for `<inline-formula>` are now covered by rules 100 and 101. jats-1.3-rule-100 - Updated to also check that the count of `<inline-graphic>` child elements is less than two. jats-1.3-rule-101 - Rule description modified to note the use of `<inline-graphic>` instead of `<inline-formula>`. jats-1.3-rule-121 - Updated to exclude the JSAP journals which do not have a `<title>` element in their `<ref-list>`. jats-1.3-rule-135 - Added to show an error if a contributor has no child `<surname>` element. jats-1.3-rule-136 - New rule to show an error if `<graphic>` children of `<fig>` have a `@content-type` attribute with a non-allowed value. Sample & Example File Changes All articles updated to validate against the new validation rules.
14/11/2024	v1.2	Documentation Changes Related Articles - Updated to allow comment-on and reply-toas valid values of `@related-article-type`. Emails - Added instructions for emails that require the author name specified. CSTR ID - New topic covering instructions for capturing CSTR IDs. Summary Abstract - New topic covering instructions for capturing summary abstracts. Validation Changes jats-1.3-rule-002 - Updated to allow retraction as an allowed value of `@article-type` on the root element. jats-1.3-rule-006 - Updated to no longer enforce a ppub ISSN on the journal STMP. jats-1.3-rule-055 - Updated to allow comment-on and reply-toas valid values of `@related-article-type`. jats-1.3-rule-124 - Severity updated from a warning to an error. jats-1.3-rule-125 - Added to warn when DOIs in `<pub-id>` include characters which may cause problems when submitted to Crossref. jats-1.3-rule-126 - Added to give an error when `<pub-id>`[`@pub-id-type`=doi occurs twice in a `<element-citation>`. jats-1.3-rule-127 - Added to give an error if `<element-citation>` contains more than one `<fpage>`, `<lpage>`, `<elocation-id>`, `<year>`,`<volume>` `<source>` or `<isbn>` child element. jats-1.3-rule-128, 129, 130, 131 - Added to validate the content of `<isbn>` elements. jats-1.3-rule-132 - Added to give an error when some descendants of `<element-citation>` are empty. jats-1.3-rule-133 - Added to warn when the contents of `<element-citation>`/`<edition>` is longer the 16 characters. jats-1.3-rule-134 - Added to warn when the contents of `<funding-source>` is longer then 131 characters. Sample & Example File Changes jinst_18_11_P11012.xmladded for Contributor Role Taxonomy (CRediT). bf_17_2_025002.xml and apj_960_1_13.xml added for Data DOIs All articles updated to validate against the new validation rules.
28/06/2024	v1.1	Documentation Changes Root Element - Updated to include retraction as an allowed value of `@article-type` on the root element. Footnotes - Updated to reflect that a `@id` attribute is not required when `<fn>` is a child of `<table-wrap-foot>`. Validation Changes jats-1.3-rule-003 - Updated to no longer check for the presence of a coden code on the journal JSTAT. jats-1.3-rule-006 - Updated to validate the presence of print ISSNs on the journals PMEA and PMB. jats-1.3-rule-108 - Updated to allow `<fn>` elements that are children of `<table-wrap-foot>` to omit an `@id` attribute. jats-1.3-rule-124 - Added a warning for references when the content of `<pub-id>` with `@pub-id-type`="doi" does not follow the standard pattern for a DOI. Sample & Example File Changes `<colgroup>` and its descendants removed from example tables to match the documentation.
26/06/2024	v1.0	Documentation Changes Collection - Updated topic to correct the instructions for capturing collection information. Validation Changes jats-1.3-rule-013 - Updated to match the corrected instructions for capturing collection information.
18/04/2024	v0.3	Documentation Changes Publishing Partner - New topic covering instructions for publishing partners. Machine Readable Tables (MRT) - New topic covering instructions for machine readable tables. Data Behind the Figure (AAS) - New topic covering instructions for capturing data behind the figure for the AAS. Affiliations - Added example of unlabelled affiliations. Standard Abstract - `<title>` child element is no longer mandatory. Figure Sets - Added instructions for capturing print and online linking text. Video Figures - Added instructions for capturing print and online linking text. Extended Figures - Added instructions for capturing print and online linking text. Interactive Figures - Added instructions for capturing print and online linking text. Reference List - `<title>` child element is no longer mandatory. Tables - Added instruction that `@position` must be included as an attribute of `<table-wrap>`. Boxed Text - Added instruction that `@position` must be included as an attribute of `<boxed-text>`. Graphical Abstract - Removed references to `<label>` and `<caption>` elements which are not required. Validation Changes jats-1.3-rule-017 - Updated to only check the children of `<article-title>` against the allowed list as opposed to a descendant of `<article-title>` jats-1.3-rule-040 - Updated to correct the rule context on `@content-type` from 'suppdata' to 'supp-data'. jats-1.3-rule-041 - Updated to correct the rule context on `@content-type` from 'suppdata' to 'supp-data'. jats-1.3-rule-056 - Updated to reduce severity to a warning rather then error. jats-1.3-rule-079: Updated to correct the rule context. This rule no longer applies to a `<fig>` elements which are part of video or graphical abstracts or is descendant of `<fig-group>` jats-1.3-rule-080: Updated to correct the rule context. This rule no longer applies to a `<fig>` elements which are part of video or graphical abstracts or is descendant of `<fig-group>` jats-1.3-rule-083 - Updated to allow `<table-wrap>` to have a parent `<p>` when it is a descendant of `<abstract>` jats-1.3-rule-113 - Updated to only refer to missing `<ref>` in `<ref-list>`. jats-1.3-rule-121 - Added rule to warn if a`<title>` element is missing from `<ref-list>`. jats-1.3-rule-122: Added rule to check that machine readable tables have a valid `<ext-link>` child element. jats-1.3-rule-123: Added rule to prevent 'suppdata' as a valid value of `@content-type` in `<supplementary-material>`. Sample & Example File Changes For clarity the default attributes below were removed from elements when not required. `@xml:lang`="en" `@orientation`="portrait" `@toggle`="yes" `@span`="1" `@colspan`="1" `@rowspan`="1" `@name-style`="western" `<pub-date>`[`@pub-type`="epub"] and children removed from samples where they are not required. `@position`="float" added to `<table-wrap>` where it was missing
15/02/2024	v0.2	Supplier Review Version
01/11/2023	Draft Release	First release of the instructions for internal review.

09/06/2025

v1.4

Documentation Changes

Corridor (AAS) - Updated to add Planetary Science as a new AAS Corridor.
CRediT – Contributor Role Taxonomy - New topic to cover capture instructions for Contributor Role Taxonomy terms.
Supplementary Data (DOIs) - New topic to cover instructions for supplementary data files with DOIs.
Supplementary Data (AAS) - New topic to cover instructions for AAS articles with supplementary data files with DOIs.

Validation Changes

jats-1.3-rule-015 - Updated to add Planetary Science as an allowed value for AAS Corridors.
jats-1.3-rule-076 - Updated to allow arxivppt as a value in <custom-meta> elements to capture arXiv preprint identifiers.
jats-1.3-rule-137 - New rule to validate that child <object-id> elements of <supplementary-material> have a @pub-id-type attribute with the value doi.
jats-1.3-rule-138 - New rule to validate the format of the doi in <object-id> elements.
jats-1.3-rule-139 - New rule to validate the presence of non-empty @content-type, @id and @xlink:href for supplementary data DOIs.
jats-1.3-rule-140 - New rule to validate the presence of a non empty <label> element for supplementary data DOIs.
jats-1.3-rule-141 - New rule to validate the presence of a non empty <caption> element for supplementary data DOIs.
jats-1.3-rule-142 - New rule to validate the presence of a non empty <permissions> element for supplementary data DOIs.
jats-1.3-rule-143 - New rule to validate the presence of a non empty <copyright-statement> element for supplementary data DOIs.
jats-1.3-rule-144 - New rule to validate the presence of a non empty <copyright-year> element for supplementary data DOIs.
jats-1.3-rule-145 - New rule to validate the presence of a non empty <license> element and related attributes for supplementary data DOIs.
jats-1.3-rule-146- New rule to validate the presence of a non empty <license-p> element for supplementary data DOIs.
jats-1.3-rule-147 - New rule to validate <supplementary-material> elements have the correct @content-type for AAS Data DOIs.
jats-1.3-rule-148 - New rule to validate <supplementary-material> elements for AAS Data DOIs have a non-empty child <object-id> element.
jats-1.3-rule-149 - New rule to validate <supplementary-material> elements for AAS Data DOIs have a non empty child <graphic> element.
jats-1.3-rule-150 - New rule to validate <supplementary-material> elements for AAS Data DOIs have a non-empty child <xref> element.
jats-1.3-rule-151 - New rule to validate that <role> is only allowed as a child of <contrib> elements.
jats-1.3-rule-152 - New rule to validate the correct values for @vocab and @vocab-identifier attributes on <role> elements.
jats-1.3-rule-153 - New rule to validate that @degree-contribution attributes on <role> elements have values from the allowed list.
jats-1.3-rule-154 - New rule to validate that the @vocab-term-identifier attribute on <role> elements have values from the allowed list.
jats-1.3-rule-155 - New rule to validate that the @vocab-term attribute on <role> elements match the @vocab-term-identifier.
jats-1.3-rule-156 - New rule to validate that <role> elements must have a @vocab-term attribute with same value as text content of the node.
jats-1.3-rule-157 - New rule to validate that a single <contrib> cannot have multiple <role> elements of the same type.
jats-1.3-rule-158 - New rule to disallow the use of <attrib> elements as children of <fig>/<caption>.

Sample & Example File Changes

All articles updated to validate against the new validation rules.

31/03/2025

v1.3

Documentation Changes

Author and Editors - Updated to note that authors with only one name should be captured in a <surname> element.
Figures - Updated to note that <fig> may have up to three @content-type attributes for <graphic> as opposed to all three being required. Instruction added
Figures - Updated to clarify that a <graphic> element with @content-type attribute with the value online is required for each <fig> element.
Online Publication Date - Updated to indicate the five journals that do not use online publication dates.
Self URI (PDF) - Updated to clarify that Research Notes of the AAS does not use PDF files and is excluded from this topic.

Validation Changes

jats-1.3-rule-028 - Updated to give a warning if the contributor has no <given-names> element.
jats-1.3-rule-032 - Updated to exclude the five journals which do not contain a <pub-date> with @pub-type attribute of value epub.
jats-1.3-rule-053 - Updated to exclude Research Notes of the AAS from the rule.
jats-1.3-rule-056 - Rule deprecated for this release.
jats-1.3-rule-070 - Rule deprecated for this release.
jats-1.3-rule-080 - Scope changed to only check <fig> has a @content-type attribute with value online. Changed from a warning to an error.
jats-1.3-rule-099 - Rule deprecated for this release. All the tests for <inline-formula> are now covered by rules 100 and 101.
jats-1.3-rule-100 - Updated to also check that the count of <inline-graphic> child elements is less than two.
jats-1.3-rule-101 - Rule description modified to note the use of <inline-graphic> instead of <inline-formula>.
jats-1.3-rule-121 - Updated to exclude the JSAP journals which do not have a <title> element in their <ref-list>.
jats-1.3-rule-135 - Added to show an error if a contributor has no child <surname> element.
jats-1.3-rule-136 - New rule to show an error if <graphic> children of <fig> have a @content-type attribute with a non-allowed value.

Sample & Example File Changes

All articles updated to validate against the new validation rules.

14/11/2024

v1.2

Documentation Changes

Related Articles - Updated to allow comment-on and reply-toas valid values of @related-article-type.
Emails - Added instructions for emails that require the author name specified.
CSTR ID - New topic covering instructions for capturing CSTR IDs.
Summary Abstract - New topic covering instructions for capturing summary abstracts.

Validation Changes

jats-1.3-rule-002 - Updated to allow retraction as an allowed value of @article-type on the root element.
jats-1.3-rule-006 - Updated to no longer enforce a ppub ISSN on the journal STMP.
jats-1.3-rule-055 - Updated to allow comment-on and reply-toas valid values of @related-article-type.
jats-1.3-rule-124 - Severity updated from a warning to an error.
jats-1.3-rule-125 - Added to warn when DOIs in <pub-id> include characters which may cause problems when submitted to Crossref.
jats-1.3-rule-126 - Added to give an error when <pub-id>[@pub-id-type=doi occurs twice in a <element-citation>.
jats-1.3-rule-127 - Added to give an error if <element-citation> contains more than one <fpage>, <lpage>, <elocation-id>, <year>,<volume> <source> or <isbn> child element.
jats-1.3-rule-128, 129, 130, 131 - Added to validate the content of <isbn> elements.
jats-1.3-rule-132 - Added to give an error when some descendants of <element-citation> are empty.
jats-1.3-rule-133 - Added to warn when the contents of <element-citation>/<edition> is longer the 16 characters.
jats-1.3-rule-134 - Added to warn when the contents of <funding-source> is longer then 131 characters.

Sample & Example File Changes

jinst_18_11_P11012.xmladded for Contributor Role Taxonomy (CRediT).
bf_17_2_025002.xml and apj_960_1_13.xml added for Data DOIs
All articles updated to validate against the new validation rules.

28/06/2024

v1.1

Documentation Changes

Root Element - Updated to include retraction as an allowed value of @article-type on the root element.
Footnotes - Updated to reflect that a @id attribute is not required when <fn> is a child of <table-wrap-foot>.

Validation Changes

jats-1.3-rule-003 - Updated to no longer check for the presence of a coden code on the journal JSTAT.
jats-1.3-rule-006 - Updated to validate the presence of print ISSNs on the journals PMEA and PMB.
jats-1.3-rule-108 - Updated to allow <fn> elements that are children of <table-wrap-foot> to omit an @id attribute.
jats-1.3-rule-124 - Added a warning for references when the content of <pub-id> with @pub-id-type="doi" does not follow the standard pattern for a DOI.

Sample & Example File Changes

<colgroup> and its descendants removed from example tables to match the documentation.

26/06/2024

v1.0

Documentation Changes

Collection - Updated topic to correct the instructions for capturing collection information.

Validation Changes

jats-1.3-rule-013 - Updated to match the corrected instructions for capturing collection information.

18/04/2024

v0.3

Documentation Changes

Publishing Partner - New topic covering instructions for publishing partners.
Machine Readable Tables (MRT) - New topic covering instructions for machine readable tables.
Data Behind the Figure (AAS) - New topic covering instructions for capturing data behind the figure for the AAS.
Affiliations - Added example of unlabelled affiliations.
Standard Abstract - <title> child element is no longer mandatory.
Figure Sets - Added instructions for capturing print and online linking text.
Video Figures - Added instructions for capturing print and online linking text.
Extended Figures - Added instructions for capturing print and online linking text.
Interactive Figures - Added instructions for capturing print and online linking text.
Reference List - <title> child element is no longer mandatory.
Tables - Added instruction that @position must be included as an attribute of <table-wrap>.
Boxed Text - Added instruction that @position must be included as an attribute of <boxed-text>.
Graphical Abstract - Removed references to <label> and <caption> elements which are not required.

Validation Changes

jats-1.3-rule-017 - Updated to only check the children of <article-title> against the allowed list as opposed to a descendant of <article-title>
jats-1.3-rule-040 - Updated to correct the rule context on @content-type from 'suppdata' to 'supp-data'.
jats-1.3-rule-041 - Updated to correct the rule context on @content-type from 'suppdata' to 'supp-data'.
jats-1.3-rule-056 - Updated to reduce severity to a warning rather then error.
jats-1.3-rule-079: Updated to correct the rule context. This rule no longer applies to a <fig> elements which are part of video or graphical abstracts or is descendant of <fig-group>
jats-1.3-rule-080: Updated to correct the rule context. This rule no longer applies to a <fig> elements which are part of video or graphical abstracts or is descendant of <fig-group>
jats-1.3-rule-083 - Updated to allow <table-wrap> to have a parent <p> when it is a descendant of <abstract>
jats-1.3-rule-113 - Updated to only refer to missing <ref> in <ref-list>.
jats-1.3-rule-121 - Added rule to warn if a<title> element is missing from <ref-list>.
jats-1.3-rule-122: Added rule to check that machine readable tables have a valid <ext-link> child element.
jats-1.3-rule-123: Added rule to prevent 'suppdata' as a valid value of @content-type in <supplementary-material>.

Sample & Example File Changes

For clarity the default attributes below were removed from elements when not required.
- @xml:lang="en"
- @orientation="portrait"
- @toggle="yes"
- @span="1"
- @colspan="1"
- @rowspan="1"
- @name-style="western"
<pub-date>[@pub-type="epub"] and children removed from samples where they are not required.
@position="float" added to <table-wrap> where it was missing

15/02/2024

v0.2

Supplier Review Version

01/11/2023

Draft Release

First release of the instructions for internal review.