README template
The quality of data documentation facilitates its understanding and reuse.
A README might be necessary to provide more details about the production context and/or data files. It is complementary with the metadata entered while depositing, the data dictionary (which it may contain) and/or any other accessible supporting material.
This README template is provided in order to help you structure your documentation. Feel free to adapt it according to your specific needs :
- Download the README model in txt (alternatively, a French version is also available);
- Download the README model in md (alternatively, a French version is also available).
A preview :
<Help text is included in angle brackets and should be deleted before saving.>
<A README: Why ?
***The documentation of a dataset should be sufficient to enable any reuser to understand and evaluate its quality. The README provides complementary and accessible information that is not provided through the dataset’s metatada, and its file’s metadata, and/or associated files, or files that are publicly accessible on a long term hosting service (file storage or publication). In the latter case, please include the documents’ persistent URLs or their references***.>
<Prefer text document (.txt,) or markdown (.md) as file format>
RDG README File Template --- General --- Version: 0.1 (2022-10-04)
This README file was generated on [YYYY-MM-DD] by [NAME].
Last updated: [YYYY-MM-DD].
# GENERAL INFORMATION
## Dataset title:
## DOI:
## Contact email:
<Here is a list of suggested items to help you enrich your documentation if necessary. Some may not be applicable, depending on the dataset’s discipline or context of production.>
<***Remove or add any section if applicable***>
# METHODOLOGICAL INFORMATION
## Environmental/experimental conditions:
## Description of sources and methods used to collect and generate data:
<If applicable, describe standards, calibration information, facility instruments, etc. >
## Methods for processing the data:
< If applicable, describe how submitted data were processed and include details that may be important for data reuse or replication. Add comments to explain each step taken.
For example, include data cleaning and analysis methods; code and/or algorithms, de-identification procedures for sensitive data human subjects or endangered species data.>
## Quality -assurance procedures performed on the data:
## Other contextual information:
<Any information that you consider important for the evaluation of the dataset’s quality and reuse thereof: for example, information about the software required to interpret the data.
If applicable and not covered above, include full name and version of software, and any necessary packages or libraries needed to read and interpret the data, *e.g.* to run scripts.>
# DATA & FILE OVERVIEW
## File naming convention:
## File hierarchy convention:
# DATA-SPECIFIC INFORMATION FOR: [FILENAME]
<Repeat this section for each folder or file, as appropriate. Recurring items may also be explained in a common initial section.>
<For tabular data, provide a data dictionary/code book containing the following information:>
## Variable/Column List:
For each variable or column name, provide:
-- full “human readable” name of the variable,
-- description of the variable,
-- unit of measurement if applicable,
-- decimal separator *i.e.* comma or point if applicable
-- allowed values : list of values or range, or domain
-- format if applicable, e.g. date>
## Missing data codes:
<Define codes or symbols used to indicate missing data.>
## Additional information:
<Any relevant information you consider useful to better understand the file>