Difference between revisions of "Track Version Changes"

From Dryad wiki
Jump to: navigation, search
(Instructions)
m (Instructions)
Line 12: Line 12:
 
== Instructions ==
 
== Instructions ==
  
Dryad depositors who wish to add a new file to their data package, to correct or clarify their data, can do so either by [mailto: curator@datadryad.org contacting the Dryad curator], who will handle adding the file to the data package, or by depositing a new version of the file themselves.  
+
Dryad depositors who wish to add a new file to their data package, to correct or clarify their data, can do so either by [mailto: curator@datadryad.org contacting the Dryad curator], who will handle adding the file to the data package, or by depositing a new version of the file themselves.
  
 
To add an additional data file to your data package, follow these steps:
 
To add an additional data file to your data package, follow these steps:
# login to the [http://datadryad.org/password-login Dryad submission system]
+
# Login to the [http://datadryad.org/password-login Dryad submission system]
# choose My Submissions from the menu on the left sidebar
+
# Choose My Submissions from the menu on the left sidebar
# view your unfinished submissions and archived submissions, and select the one to which you wish to add a file  
+
# View your unfinished submissions and archived submissions, and select the one to which you wish to add a file
# follow the submission process again, just as you did with the initial file upload, to upload the new file  
+
# Follow the submission process again, just as you did with the initial file upload, to upload the new file
# you will be asked to explain the reason for this upload; please provide a brief explanation of the reason for this new file. Your explanation will become publicly visible when the curator approves the data submission.
+
# You will be asked to explain the reason for this upload; please provide a brief explanation of the reason for this new file. Your explanation will become publicly visible when the curator approves the data submission.
  
 
== Technical Documentation ==
 
== Technical Documentation ==

Revision as of 13:12, 4 June 2012

Status: Implementations complete and in testing. Scheduled for Release 1.11.

THIS PAGE UNDER CONSTRUCTION (May 30, 2012)

This page describes the versioning system, which enables depositors of data to add a subsequent version of a data file, usually to correct an error in the original file, or to provide the data in a different format.

Overview

The Dryad submission system allows depositors to add a new version of a data file. A major focus of Dryad is archival preservation of the scientific record, so the repository always will retain the original data file(s) as submitted, but in some cases authors may wish to correct errors in the archived data. The versioning system allows this. Dryad does not allow authors to use versioning to add additional information that was not part of the original analysis reported in the associated publication.

If a file has multiple versions, the most current one will always be displayed by default. Earlier file versions will be listed on the data package page....

Instructions

Dryad depositors who wish to add a new file to their data package, to correct or clarify their data, can do so either by [mailto: curator@datadryad.org contacting the Dryad curator], who will handle adding the file to the data package, or by depositing a new version of the file themselves.

To add an additional data file to your data package, follow these steps:

  1. Login to the Dryad submission system
  2. Choose My Submissions from the menu on the left sidebar
  3. View your unfinished submissions and archived submissions, and select the one to which you wish to add a file
  4. Follow the submission process again, just as you did with the initial file upload, to upload the new file
  5. You will be asked to explain the reason for this upload; please provide a brief explanation of the reason for this new file. Your explanation will become publicly visible when the curator approves the data submission.

Technical Documentation

Documentation on atmire wiki:

Design History

Versioning was developed in late 2011 and early 2012, and released to users in March 2012.

Goal: The history of an item should be available, and it should be possible to cite a particular version of the item.

Requirements:

  1. Data packages and data files have a relationship between their identifiers. Each version of a file/package is represented by a separate DOI. The "base" DOI points to the most recent version of the file/package, but a version number can be added to the base DOI to access previous versions. See the DOI Usage page for more details about the DOI format.
  2. When a new version of data file is deposited, a new identifier will be created for the data file item, as well as the containing data package item.
  3. Adding or changing README files or metadata will not result in creation of a new identifier.
  4. All metadata changes are logged by writing a metadata snapshot to the filesystem -- this allows us to retain a record of the changes, even though they are not available as explicit versions (and not viewable in the UI). Each item's metadata should record the time of last modification.
  5. If all we are doing is adding a new bitstream without changing the existing bitstreams, there is no need to force a version number change.
  6. When a new identifier is created for a data file, a new identifier is automatically created for the corresponding data package.
  7. Each version of the item includes metadata about who created the version and the date/time. (it is essentially a full copy of the item, with modifications)
  8. Only the most recent version of an item is available via the search interface.
  9. On the item page, there is a link to view previous/subsequent versions.
  10. By examining the metadata, it is possible to determine whether an item is the most recent version, the original version, or an intermediate version. This information is machine-readable.
  11. Previous versions of bitstreams are retained. If something was once retrievable, it is always retrievable.
  12. Creation of a new version is initiated by the submitter. On the "submissions" page, users should see all of their archived submissions. Each archived submission should have a button to submit a new version of a data file.