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

Decide on format for preferred citation for standards #32

Closed
peterdesmet opened this issue Jun 3, 2015 · 15 comments
Closed

Decide on format for preferred citation for standards #32

peterdesmet opened this issue Jun 3, 2015 · 15 comments
Assignees
Labels

Comments

@peterdesmet
Copy link
Member

As outlined in this guidelines document, we will add a preferred citation for each standard in the README. The preferred citation (with updated release number and year) can also be listed for each release. This citation should at least include:

  • permanent URL
  • name of the standard

and preferably:

  • authors
  • year
  • release/version number
  • indication of "draft standard" (for 0.x releases)

and maybe:

It would be convenient if we can decide on a standard format for this preferred citation, which I can then include in the guidelines document and which I'll add to every README and release on GitHub.

My suggestion

Last name First name, Last name First name. year. Full name of the standard + (draft standard) if applicable, Version releasenumber or date. Biodiversity Information Standards (TDWG) http://www.tdwg.org/standards/id (no trailing slash)

For example:

Wieczorek John, Döring Markus, De Giovanni Renato, Robertson Tim, Vieglais Dave, Desmet Peter. 2014. Darwin Core, Version 2014-11-08. Biodiversity Information Standards (TDWG) http://www.tdwg.org/standards/450

New versions can have more authors.

Other suggestions

By @baskaufs in this comment:

Hyam, Roger. 2007. TDWG Standards Documentation Specification (draft standard). TDWG Infrastructure Project. 2007-11-05 version. http://www.tdwg.org/standards/147

By @ramorrismorris in this comment:

Morris, Robert A., et al., 2014. Audubon Core Multimedia Resources Metadata Schema, Release 1.0, http://www.tdwg.org/standards/638/

Currently listed for Darwin Core:

Darwin Core Task Group, Biodiversity Information Standards (TDWG). 2009. Darwin Core.
http://rs.tdwg.org/dwc/ (accessed on 2014-10-31).

Listed in a Darwin Core release:

Wieczorek, John et al. (2014). Darwin Core: 2014-11-08. Zenodo. 10.5281/zenodo.12694

Suggested for LSID applicability statement:

TDWG Life Sciences Identifiers (LSID) Applicability Statement, TDWG Draft Standard, TDWG Globally Unique Identifiers Task Group (Ricardo Pereira, Kevin Richards, Donald Hobern, Roger Hyam, Lee Belbin, Stan Blum), Sept 2009, http://www.tdwg.org/standards/150

Please comment on how we should format this, including punctuation (e.g. between names and for year).

/cc @tdwg/exec

@pmergen
Copy link

pmergen commented Jun 10, 2015

Hi
I would be in favor of a citation format where TDWG is of course mentioned, but also the names of the co-authors (but as those may vary in time, has to keep updated).
Walso need some flexibility as some journals have standard citation formats rules.

in some cases additional to the citation only, you may have to add a request to acknowledge other contributing institutions or funding bodies (who request this in many cases)

More generally you may want to add some information on using the logo(s) and in which context.

@CynthiaParr-USDA
Copy link
Member

Suggestion: use Biodiversity Information Standards (TDWG) as the publisher.

Provide a bibtex formatted text file.

@CynthiaParr-USDA
Copy link
Member

Need to resolve in the next few days.

@peterdesmet
Copy link
Member Author

Deadline: July 2

@pmergen
Copy link

pmergen commented Jun 25, 2015

Hi
For online content citations date accessed is a standard request from many journals and others. Would thus recommend we suggest to have it as it is a best practice advise.

@peterdesmet
Copy link
Member Author

Since the citation indicates the release date, a date accessed doesn't provide much more information, so I would not include this.

@pmergen
Copy link

pmergen commented Jun 25, 2015

yes that is what I meant not to put in in the citation example.

but if room, indicated that some journals request it in an additional sentence . but that is my "helpdesk" side.

@peterdesmet
Copy link
Member Author

I see. 😄 As discussed in the call, it's a preferred citation. A journal will probably have other requirements regarding the format, but at least we indicate what we would like to have in there.

@dkoureas
Copy link
Member

@peterdesmet Following today's XC meeting, please find below an example bib record for the Darwin Core Standard. I set the reference type to 'misc' as no other type seems to match for referencing a Standard. I also chose to add the release date to the 'edition' field. Any reference manager software can parse this and deliver a citation format according to any common format.

@misc {DarwinCore2014,
title = {Darwin Core},
year = {2014},
publisher = {Biodiversity Information Standards (TDWG)},
edition = {Release 2014-11-08},
url = {http://www.tdwg.org/standards/450},
author = {Wieczorek, John and D{"o}ring, Markus and De Giovanni, Renato and Robertson, Tim and Vieglais, Dave and Desmet, Peter}
}

@baskaufs
Copy link
Collaborator

baskaufs commented Jul 4, 2015

@CynthiaParr-USDA
Copy link
Member

Is there anything left to do on this @peterdesmet ?

@AaronWilton
Copy link

Sorry to have missed the conversations in the meeting(s), so hope this doesn't re-open/duplicate debate.

The initial question was around a preferred citation format, but that now seems to have translated into the preferred fields that should be included in the bibliographic information. Was discussion still given to providing a recommended citation format so there is consistency across TDWG standards? (I still see some value in this).

If yes, then the format of the author string seems rather non-standard for a citation (appropriate for content). It is more typical for multiple authors to be separated by semi-colons or commas in a citation.

@peterdesmet
Copy link
Member Author

I'd like to close this discussion. To keep things simple, I'll add Biodiversity Information Standards (TDWG) as a publisher to the preferred citation. The preferred citation will be indicated as a blockquote at the end of the README file of a standard, but I will not add a bibtex to the repository (because then we need to maintain two files). So, an example of a preferred citation is:

Wieczorek John, Döring Markus, De Giovanni Renato, Robertson Tim, Vieglais Dave, Desmet Peter. 2014. Darwin Core, Version 2014-11-08. Biodiversity Information Standards (TDWG) http://www.tdwg.org/standards/450

And if the authors are not readily known, I'll use the task group as the author (can be updated later):

Access to Biological Collections Data task group. 2007. Access to Biological Collection Data (ABCD), Version 2.06. Biodiversity Information Standards (TDWG) http://www.tdwg.org/standards/115

@peterdesmet
Copy link
Member Author

Updated to use the word version instead of release (as suggested by @timrobertson100)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

6 participants