gbif / doc-publishing-dna-derived-data

This guide shows how to publish DNA-derived spatiotemporal biodiversity data and make it discoverable through national and global biodiversity data discovery platforms. Based on experiences from Australia, Norway, Sweden, UNITE, and GBIF.
https://doi.org/10.35035/doc-vf1a-nr22
Other
2 stars 7 forks source link

Many references missing from the tail list #143

Closed dschigel closed 3 years ago

dschigel commented 3 years ago

Including in e.g. in this section.

Suggested action: cross-check of all references in the doc required: all bibliographic references in the text should be in the reference list, which should not have any references which are not found in the text.

dschigel commented 3 years ago

As discussed in Skype with @kcopas, I suggest we follow the basic principle that simple hyperlinks from the text do not require addition to the ref list. However, if the reference looks like bibliographic, or the link target is as doc with ISSN / ISBN, an addition is needed.

Example where no new reference needed in the tail list:

Furthermore, some fields from the GGBN standard and fields from the MIQE (minimum information for the publication of quantitative real-time PCR) guidelines for qPCR and ddPCR data have been included to make it applicable for a wide range of DNA-derived data.

Example where ref is missing and addition to the list is needed:

DNA-metabarcoding is used for samples originating from both terrestrial and aquatic environments, including water, soil, sediments, biofilms, plankton, bulk samples and faces, simultaneously identifying hundreds of species (Ruppert et al. 2019).

dschigel commented 3 years ago

Will do manual text to list check to start with

dschigel commented 3 years ago

To add to the reference list, respecting the target format and ordering (list below is not sorted)

Not referred in the text biobliographically, add text references where relevant (preferred), or remove from reference list

Overall formatting for the reference list is unsatisfactory, closing dots or not, first names spelled out or not etc. Careful checks desirable, but not critical to do before release: silent formatting / style improvements can be done on the go.

thomasstjerne commented 3 years ago

Most of the references in the numbered list are from this sentence where they are mentioned by the name of the tool/algorithm (hyperlinked to the DOI):

Several open source tools and algorithms exist for bioinformatic processing of metabarcoding data (QIIME2, DADA2, SWARM, USEARCH, Mothur, LULU, PROTAX).

1 - QIIME2 3 - DADA2 4 - Mothur 5 - USEARCH 6 - PROTAX 7 - LULU 8 - SWARM

Ref nr 2 on the list is mentioned in the sentence (as Callahan et al. 2017):

Availability of of all verified amplicon sequence variants (Сallahan et al. 2017) allow for precise reinterpretation of data

So please don´t remove those

dschigel commented 3 years ago

@thomasstjerne I agree to keep; each of them would need a bibliographic reference, not only a hyperlink - this is breaking the bibliographic standard. In my opinion it is ok to simply link out to a webpage, but it is no ok to omit a bibliographic reference when i) paper is found on the list but there is no obvious reference in the text and ii) other papers are referred to correctly. I can fix this, preserving 1, 3, 4, 5, 6, 7, 8. We are in sync here.

dschigel commented 3 years ago

Added missing references to the text, now every ref in the list has at least one ref from the text

dschigel commented 3 years ago

Added missing references to the list and fixed most horrible biobliographic formatting issues. A chance I overlooked some commas and spaces, to fix on the go.