diff --git a/src/modality-agnostic-files.md b/src/modality-agnostic-files.md index d598f76e38..fda6643276 100644 --- a/src/modality-agnostic-files.md +++ b/src/modality-agnostic-files.md @@ -167,6 +167,26 @@ A guide for using macros can be found at --> {{ MACROS___render_text("objects.files.README.description") }} +### `CITATION.cff` + + +{{ MACROS___render_text("objects.files.CITATION.description") }} + +For most redundant fields between `CITATION.cff` and `dataset_description.json`, +the `CITATION.cff` SHOULD take precedence. +To avoid inconsistency, metadata present in `CITATION.cff` SHOULD NOT be +be included in `dataset_description.json`, with the exception of `Name` and +`DatasetDOI`, to ensure that `CITATION.cff`-unaware tools can generate +references to the dataset. +In particular, if `CITATION.cff` is present, +the `"Authors"` field of `dataset_description.json` MUST be omitted, +and the `"HowToAcknowledge"`, `"License"` and `"ReferencesAndLinks"` SHOULD be omitted +in favor of the `CITATION.cff` fields `message`/`preferred-citation`, `license` and +`references`. + ### `CHANGES`