Publish and Archive

Let’s think about the future…

Will this repository still be here in five years?

Will my account?

Will GitHub?

Archiving the project

zenodo-part3

Zenodo has a sandbox environment!

  • Not the main data repository, but still functional.
  • You will get an actual DOI, and your project will (probably?) not be deleted!
  • Only do this following exercise if you are OK with your code staying online!
  • You will not be able to do this with a private repository.

Zenodo and Github have a pipeline that makes your life easier! (Check the full how-to on GitHub.)

Your turn:

  • Go to: sandbox.zenodo.org, and log in with GitHub. (If you do not have GitHub, simply sign up for a zenodo account; some of the coming steps you will need to do manually…)
  • GitHub will then ask permission to give Zenodo access; click “Authorize application”.

Select your repository

toggle

Release your project!

release

… and follow the workflow!

Semantic versioning

A version has three numbers: MAJOR.MINOR.PATCH

  • MAJOR version denotes changes that alter the compatibility (i.e. someone using your functions may need to change their use for their code to still work),
  • MINOR version adds functionality, but remains compatible
  • PATCH version makes (compatible) bug fixes.

(If your bug fix changes compatibility, it is therefore a MAJOR version change!)

You can release today with v0.1.0

Check zenodo

Your code is now uploading to Zenodo: you can check it under the ‘upload’ tab:

citable-upload

Getting your DOI

  • Add some final descriptions
  • Click ‘publish’
  • Voilá!

zenodo-upload

Getting your DOI

Do you know your DOI?

As a final touch (only with real Zenodo!): you can take your DOI and place it as a badge at the top of your README.

[![DOI](https://zenodo.org/badge/doi/YOUR.DOI.svg)](http://dx.doi.org/YOUR.DOI)

This is not recommended with a Sandbox DOI, because sandbox projects are not permanent. The Sandbox DOI will not work like a normal one does!