Linking taxa to literature (and vice versa)

gbif / portal-feedback

User feedback for the GBIF API, website and published data. You can ask questions here. 🗨❓

30 stars 16 forks source link

Linking taxa to literature (and vice versa) #3671

Open dnoesgaard opened 3 years ago

dnoesgaard commented 3 years ago

Let's add a tab for relevant literature (if any) to taxon pages, e.g,

lit-on-taxon-pages

The tab should then embed a search like we do on country pages for literature, but having the filter gbifTaxonKey=<taxonKey>

It would be great to have a small snippet of translatable text at the top of the search to be able to explain the linking.

Example: https://www.gbif-dev.org/species/5668821 https://api.gbif-dev.org/v1/literature/search?gbifTaxonKey=5668821

Similarly, we could add a filter to the literature search to allow filtering literature by taxon.

MortenHofft commented 3 years ago

On some species pages we also show a treatment coming from Plazi. Which must be considered literature as well. In this version, it would then show 2 tabs. And the treatment might not appear in the literature tab.

And some species pages will have a treatment, but still might not have a literature tab.

This feels a bit odd to me, but I do not have any good suggestions on how to change it.

dnoesgaard commented 3 years ago

Hmm. Obviously there's a difference that perhaps need to be implied the the name.

How do we say "GBIF-relevant literature relating to this taxon" in one word?

ManonGros commented 3 years ago

I assume the PLAZI treatment is actually the reference for this taxon, isn't it?

If so, then the PLAZI tab could be called "reference" and the literature tab could be "related literature", would that work?

MortenHofft commented 3 years ago

Currently the plazi tab is called treatment. And the word reference is used to refer to the checklist it came to us from. They are not always the same

dnoesgaard commented 3 years ago

I don't have a problem with showing treatments and/or literature on separate tabs on taxon pages. I mean, they're not the same. If others find this confusing, we'll just have to make sure it's sufficiently explained?

MortenHofft commented 3 years ago

Sounds good. I'm confused myself 😄 - isn't the Plazi treatment a subset of literature about this taxon? But in most (all) cases not included in the literature index.

dnoesgaard commented 3 years ago

Treatments are datasets published by Plazi, typically based on articles in scientific journals.

The literature index includes all types of literature that as a minimum mentions GBIF.

There may be indeed be overlaps, but in those cases, the papers underlying a treatment would also be included in the literature index.

MortenHofft commented 3 years ago

@dnoesgaard could you please provide a help text for the literature search taxonKey filter?

dnoesgaard commented 3 years ago

"Note: Applying this filter will exclude papers not explicitly focused on (a) specific taxon/taxa" ?

MortenHofft commented 3 years ago

@dnoesgaard could you also provide the help for the species page please. You mock says: "Brief explanation of ..."

dnoesgaard commented 3 years ago

Rather than having a extra explainer, we could simply use the card header (currently reads "DISTRIBUTIONS")?

Text suggestion:

<n> items of GBIF-relevant literature explicitly focused on <name of taxon>

Or if we don't to include count and name, simply

GBIF-relevant literature explicitly focused on taxon

MortenHofft commented 3 years ago

That is a slightly long text for mobile as a card header. Especially given that we have a filter button in that row that would need to wrap. I've opted for a regular paragraph above instead.