[INFRA] Update `CITATION.cff` with all BIDS paper references

[sappelhoff]

Within this file:

bids-specification/CITATION.cff

Line 3 in f7d1298

cff-version: 1.2.0

we should add a section "References", as described here: https://github.com/citation-file-format/citation-file-format/blob/main/schema-guide.md#references

And in that section, we should add the data for all the papers that we list here: https://bids-specification.readthedocs.io/en/latest/introduction.html#citing-bids

[Remi-Gau]

I'd be in favor of of maybe not doing because we'll have to keep updating the citation.cff file AND the "how to cite" with every new BEP paper.
Would rather have a single place for that information.

[Remi-Gau]

or we could have the citation.file be the place where we store that info and use a macro to update the src/introduction.md

[sappelhoff]

or we could have the citation.file be the place where we store that info and use a macro to update the src/introduction.md

I would be in favor of this solution, as it'd make the "how to cite" part machine readable and standardized.

[Remi-Gau]

or we could have the citation.file be the place where we store that info and use a macro to update the src/introduction.md

I would be in favor of this solution, as it'd make the "how to cite" part machine readable and standardized.

ok so time to add some more macros...

[Remi-Gau]

Hum... Wondering if we should not put those references in a bib file and rely on mkdocs plugins.

• See Add DOI links and references section for cited papers? #403 (comment)

[sappelhoff]

Both seem to have their benefits and drawbacks.

• CITATION.cff
  • + it's part of the standardized file and may even populate zenodo metadata for the PDF spec release
  • - it'd need a custom macro to put it into the spec text
• bib file
  • + can rely on mkdocs plugins, no macro needed (??)
  • - need to add an additional file to the repo, and citation metadata is split over files

[Remi-Gau]

other + for bib file:

• allows standardization of ALL references in the spec (not many so far but makes it easy to scale up)