Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update documentation for species binomials #250

mbjones opened this issue Mar 12, 2017 · 2 comments

update documentation for species binomials #250

mbjones opened this issue Mar 12, 2017 · 2 comments


Copy link

@mbjones mbjones commented Mar 12, 2017

Author Name: Margaret O'Brien (Margaret O'Brien)
Original Redmine Issue: 5704,
Original Date: 2012-09-04
Original Assignee: Matt Jones

The EML documentation needs an update to reflect correct practice when including a taxonomic species name. Taxonomically speaking, the 'species name' is a genus and the specific epithet. But looking at it from a strictly hierarchical node structure the specific epithet looks and acts like the other nodes. However a node 'alterniflora' has no taxon rank by itself.

LTER already reccommends this construction in its Best Practices, but actual implementations are inconsistent, perhaps because of the normative documentation.

Another note: The normative docs also seem to refer to "Acer rubrum" as the 'common name' of Red Maple, which is incorrect..

Here is an example of 2 implementations sent to eml-dev (from Wade Sheldon):

with binomial:

Genus Spartina Species Spartina alterniflora

without binomial:

Genus Spartina Species alterniflora

Here is the text from the EML 2.1.1 normative docs:
seem to suggest the opposite approach:

"The name representing the taxonomic rank of the taxon being described.
The values included may be referenced from an authoritative source such
as the Integrated Taxonomic Information System (ITIS)in the U.S.
(http://www/ and in Canada
( Also, Species2000 is another
source of taxonomic information, found at (
Acer would be an example of a genus rank value, and rubrum would be an
example of a species rank value, together indicating the common name of
red maple. It is recommended to start with Kingdom and include ranks
down to the most detailed level possible."

Copy link
Member Author

@mbjones mbjones commented Mar 12, 2017

Original Redmine Comment
Author Name: Redmine Admin (Redmine Admin)
Original Date: 2013-03-27T21:31:24Z

Original Bugzilla ID was 5704

@mbjones mbjones added this to the Unspecified milestone Mar 12, 2017
@mbjones mbjones added this to the EML2.2.0 milestone Apr 22, 2017
@mbjones mbjones removed this from the Unspecified milestone Apr 22, 2017
@mbjones mbjones added this to TODO in EML 2.2.0 Release Apr 22, 2017
@mbjones mbjones moved this from TODO to High priority in EML 2.2.0 Release Oct 3, 2017
@mbjones mbjones added the next label Oct 30, 2017
@mobb mobb added in progress and removed next labels Jul 24, 2018
Copy link

@mobb mobb commented Aug 16, 2018

The primary issue appears to have been already fixed. here is current text:

            'Acer rubrum' would be an example of a species rank value with the 
            common name of 'Red Maple'. </doc:example>```

I updated 2 things:
1.  added quotes and capitalization to the common name
2. removed the sentence from the example that recommended including all ranks. with the addition of external refs (issue #141), this is no longer necessary - in fact we might want to recommend the opposite. 

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
EML 2.2.0 Release
High priority

No branches or pull requests

2 participants