Skip to main content

Which link to my capsule should I share with others?

If the capsule is published, its DOI is probably best; if it is private, you should add users as collaborators.

Updated over 3 years ago

Background:

You might find yourself in a position where you have a lot of links to your capsule -- potentially, a peer review link, a link to your private capsule, the URL of your published capsule, and the published capsule's DOI. Here's how to make sense of that.

What each link is:

  1. When you publish a capsule, it's intended to be a snapshot of the project at a particular moment -- for example version 1.0 , 2.0, etc. So a published capsule's URL for example https://codeocean.com/capsule/8235972/tree/v7 is a link to that particular snapshot.

  2. Published capsules also have DOIs, for example https://doi.org/10.24433/CO.4024382.v7.
    DOIs are intended to be persistent IDs that always resolve to the right URL, even if that URL changes over time

  3. Your private capsule, from which the public capsule is forked, is only accessible via a link to you, and anyone added as a collaborator.  The idea is that you can continue to make changes that aren't publicly available, until you elect to publish. If you share a link to the private capsule with someone who isn't a collaborator, they'll see some variant of 'capsule not found'.

  4. A peer review copy is a fork of a capsule with certain peer-review-centric features (e.g. analytics). This should only be shared with peer reviewers and editors who will manage this rather than authors. 


​

Did this answer your question?