cafi-2019-data

DOI and Versioning Guide

About Digital Object Identifiers (DOIs)

A DOI (Digital Object Identifier) is a permanent identifier that ensures long-term access to your dataset, even if the location (URL) changes.

Planned DOIs for This Dataset

This dataset will receive multiple DOIs from different repositories to meet NSF requirements and maximize accessibility:

1. BCO-DMO (Required by NSF)

2. EDI/LTER (MCR-LTER)

3. Zenodo (via GitHub)


Understanding DOIs and Dataset Updates

Can You Update Data After Getting a DOI?

Yes, but it works through versioning:

  1. Original DOI remains unchanged and points to Version 1
  2. New versions get new DOIs (e.g., v1.0, v1.1, v2.0)
  3. Landing page links all versions so users can find the latest
  4. Old versions remain accessible for reproducibility

How It Works in Practice:

BCO-DMO Versioning:

Zenodo Versioning:


Best Practices

Before Requesting DOI:

  1. ✅ Thorough quality control - Check data carefully
  2. ✅ Complete metadata - All README files finalized
  3. ✅ Clear documentation - Methods and column descriptions complete
  4. ✅ Consistent formatting - File naming and structure standardized
  5. ✅ Co-author review - Have Craig (and others) review everything

After Receiving DOI:

  1. Minor fixes (typos in README, clarifications) → Create new version
  2. Data corrections (fixed values, added columns) → Create new version, document changes
  3. Major updates (new data, different methods) → Consider new dataset with new DOI

Version Documentation:

Always document what changed between versions in:


Current Version

Version 2.6 (2025-01-03)

Version History:


Updating This Dataset in the Future

If you need to make changes after DOI assignment:

  1. For GitHub/Zenodo:
    # Make your changes to files
    git add .
    git commit -m "v2.3: [describe changes]"
    git tag -a v2.3 -m "Version 2.3: [describe changes]"
    git push origin main --tags
    

    Zenodo will automatically create a new version with a new DOI.

  2. For BCO-DMO:
    • Contact BCO-DMO data managers
    • Submit updated files with version notes
    • They will create a new version entry
  3. For EDI/LTER:
    • Contact Hillary (MCR Data Manager)
    • Submit updated files with version notes
    • EDI will create a new version entry

Always Include:


Questions About DOIs?


Key Takeaway

DOIs are permanent, but datasets are not frozen. You can always create new versions with new DOIs. The DOI system is designed to balance permanence (for citations) with flexibility (for corrections and updates).