Data Management Skillbuilding Hub

Best Practice: Provide version information for use and discovery

BEST PRACTICE

Best Practices by Data Life Cycle




Provide version information for use and discovery

Data Life Cycle stage(s): Assure   Preserve

Provide versions of data products with defined identifiers to enable discovery and use.

Items to consider when versioning data products:

  • Develop definition of what constitutes a new version of the data, for example:
    • New processing algorithms
    • Additions or removal of data points
    • Time or date range
    • Included parameters
    • Data format
    • Immutability of versions
  • Develop standard naming convention for versions with associated descriptive information
  • Associate metadata with each version including the description of what differentiates this version from another version

Description Rationale

Data products potentially change through time as they are developed using new or improved algorithms or based upon different source data. Providing versions with defined identifiers will enable users to determine the appropriate version of the data to use for their particular application and allow them to properly cite the data used in an analysis allowing others to replicate their work.

Additional Information

NASA Modis versioning using processing levels and collections:

Tags

 
 
 
 

Cite this best practice:

DataONE Best Practices Working Group, DataONE  (January 12, 2014) "Best Practice: Provide version information for use and discovery". Accessed through the Data Management Skillbuilding Hub at https://dataoneorg.github.io/Education/bestpractices/provide-version-information on Aug 22, 2019


Home

Hosted by DataONE

In collaboration with the community, DataONE has developed high quality resources for helping educators and librarians with training in data management, including teaching materials, webinars and a database of best-practices to improve methods for data sharing and management.

Question If you have a question or concern, please open an Issue in this repository on GitHub.