Skip to Main Content



Data Management Plan (DMP) Guide

Learn how to write a data management plan!

Step 3. Data documentation

Data is useful only if it has meaning and context. The most common way to give data meaning and context is through metadata, the data of data, or through supplementary files such as a data dictionary. Eliminating, or at least limiting, uncertainty is the goal of data documentation.

Writing prompts

How will you describe and document your data?

Your data documentation should contain at least the minimum information needed to be able to reuse the data it is describing. Providing metadata is one of the most common ways provide this information. There are different ways to document and describe data. Which method is best will depend on the project, your team, and the data's complexity. The important part is making sure it is done and done well.

The exact details of your documentation method will probably be established after the grant has been funded but before, or shortly after, data collection has begun.

Examples of data documentation:
Data dictionary, readme file(s), embedded metadata, data paper, etc.
Tutorials and templates

Will you be using a metadata schema(s)?

If you have no idea what this means don't worry - many areas are still in the process of creating or adopting metadata schemas. There are also projects which will never fit within the bounds of any previously defined schema.

If you are working in an area that has an established metadata schema and you are choosing to not employ it then you need to be able to articulate why this is important in your data management plan.

Example metadata schema:
  • Agricultural Metadata Element Set (AgMES)
  • Crystallographic Information Framework (CIF)
  • Darwin Core
  • Content Standard for Digital Geospatial Metadata
  • DublinCore
  • Genomics Unified Schema (GUS)
  • Standard for Documentation of Astronomical Catalogues (SDAC)

Tips

  • Data documentation complexity and detail can vary by project size and data complexity.
  • Data documentation helps not just you and your team but is also a requirement for data sharing.
  • You should work to establish data dictionaries and collection standards early on.
  • Your research paper is not an adequate way to describe data nor does it contain data (more on this later).
  • Data papers are publications that present importation on "the collection, organization, and synthesis of data, and provide thorough documentation of data sets" (Ecology submission types PDF, accessed 2023-11-20). Unlike a research paper, the focus is on the evidence (data) and not the results and findings. 

decorative image
Need help?

Data Management Questions
datashare@iastate.edu

IT Questions
researchit@iastate.edu

Quick Access
Iowa State University DataShare

DMPTool