Publish: Preserve and Share your Work

When your Tale is ready to be preserved and shared, you can publish it to external repositories. When you publish your Tale, it receives a DOI that can be cited by others.

Publishers

DataONE

DataONE is a network of data centers and organizations that share their information across a network of nodes, where data is replicated and described with rich metadata. Publishing your Tale into the DataONE network will allow you to archive your work, collect usage statistics, and make it easy to share with other scientists.

Signing Into DataONE

Depending on which repository you decide to publish to, you may have to log into DataONE if you haven’t done so already. You’ll be redirected to ORCID, and then back to Whole Tale once the login process is completed. You can use either your ORCID ID or university account with CILogon to access the DataONE system.

Publishing Your Tale

To publish your running Tale, select “Publish Tale” in the Run page menu. If you haven’t signed in to DataONE yet, you’ll be asked to do so with your ORCID.

../_images/start_publish.gif

Publishing is accessed through the Tale Run page

Once the publishing dialog is opened, select which node you want to store your Tale in. It is suggested that if this is your first time publishing a Tale, select the DataONE Development node to test the results.

../_images/run_publish.gif

Publishing to the Development node

Viewing Publishing Information

After you’ve published your Tale, you can always view the published location under the metadata tab on the Run page.

Whole Tale Generated Files

In order to preserve as much information about the computation environment, we generate files that provide extra context for the Tale. These files are included in your DataONE package. The files range from the Tale’s license, metadata documents for DataONE, and metadata about the Tale.

manifest.json

This is a metadata document that describes the Tale, which was inspired from the Research Object Lite specification. The important information contained in this file includes any external data that was used, locations of data files, and author attributes.

environment.json

The environment file contains information about the Tale’s compute environment which includes memory limits and docker information.

LICENSE

The LICENSE file describes the Tale’s license. To change the license, navigate to the metadata editor in the Run page.

README.md

The README can be used as a reference for running the Tale outside Whole Tale.

metadata.xml

Whole Tale automatically generates the DataONE EML document which includes information about the Tale that is shown to users on the dataset landing page