We want to hear from you. You're viewing the newest version of the Library's website. Please send us your feedback!
Learn |
RDM Basics & Best Practices |
Indigenous Data Sovereignty |
RDM Policies & Principles |
UWaterloo Workshops |
A README file is a required component of a data deposit. It acts as a guide to your dataset by providing an overview of your data, including what your data is, how it was labelled, and how it was collected. Above all else, be consistent with your choices throughout the lifecycle of your research to ensure clear and readable documentation.
A README file is not a replacement for the metadata required by a data repository when you deposit your data; however, metadata terms can be recorded in your README.
This README template has been created for data deposits into the University of Waterloo Dataverse by the Library’s RDM team. It has been designed for multidisciplinary usage, meaning not all information fields will be applicable for every data deposit. For best practice, include all relevant information that can support the findability, accessibility, interoperability, and reusability of your data deposit.
The template can also be used for internal data management or for deposits in other repositories.
README files should be saved as a plain text file (.txt) or a PDF (.pdf).
Common file naming conventions are camelCase, PascalCase, snake_case, and kebab-case. Templates from the University of Waterloo Library use a combination of PascalCase and snake_case. We encourage you to modify the templates for your own preferred naming convention, however do remain consistent with the style used for your project.
Example: YYYY-MM-DD or YYYY-MM or YYYY-YYYY or YYYY-MM-DD_hhmm
Example: v10 (Version 10)
Example: v01 (Version 1) instead of v1
Example: LabReport_Draft01 instead of Draft01_LabReport, or essay-v12 instead of v12-essay
Usually, project files and folders are organized in a hierarchical directory structure made up of a top-level folder (called a root directory), subfolders (called subdirectories), and related files.
For the root directory of a typical research project, there are three subdirectories—data, analysis, and reports. Here is an example directory structure, formatted as a plain text tree diagram:
er/ ├── Data/ │ ├── ---README--- │ ├── File_01 │ └── File_02 ├── Analysis/ │ ├── File_01 │ └── File_02 └── Report/ ├── File01_v01 ├── File01_v02 └── File01_v03ProjectFolder/
├── Data/
│ ├── ---README---
│ ├── File_01
│ └── File_02
├── Analysis/
│ ├── File_01
│ └── File_02
└── Report/
├── File01_v01
├── File01_v02
└── File01_v03
Do you have a discipline-specific resource to recommend for this list? Send it to us through our recommendation form, we would love to hear from you!