ENH: Add CITATION schema file and recommend preference over dataset_d…

…escription

src/modality-agnostic-files.md

@@ -167,6 +167,21 @@ A guide for using macros can be found at
 -->
 {{ MACROS___render_text("objects.files.README.description") }}
 
+### `CITATION.cff`
+
+<!-- This block generates a file tree.
+A guide for using macros can be found at
+ https://github.com/bids-standard/bids-specification/blob/master/macros_doc.md
+-->
+{{ 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.
+
 ### `CHANGES`
 
 <!-- This block generates a description.

src/schema/objects/files.yaml

@@ -12,6 +12,14 @@ CHANGES:
     [CPAN Changelog convention](https://metacpan.org/pod/release/HAARG/CPAN-Changes-0.400002/lib/\
     CPAN/Changes/Spec.pod).
     The `CHANGES` file MUST be either in ASCII or UTF-8 encoding.
+CITATION:
+  display_name: CITATION.cff
+  file_type: regular
+  description: |
+    A description of the citation information for the dataset, following the
+    [Citation File Format](https://citation-file-format.github.io/) specification.
+    This file permits more detailed and structured descriptions than
+    [dataset_description.json](SPEC_ROOT/glossary.md#dataset_description-files).
 LICENSE:
   display_name: License
   file_type: regular