astropy-tutorials
astropy-tutorials copied to clipboard
Explore making the tutorials citable
Either as a whole, or individually (get each tutorial a zenodo DOI when it is published?).
I think Guides should absolutely be individually citable, but tutorials ... probably also worth having individually citable.
On Sep 22, 2017, at 4:27 PM, Adrian Price-Whelan [email protected] wrote:
Either as a whole, or individually (get each tutorial a zenodo DOI when it is published?).
— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub, or mute the thread.
When a tutorial gets updated, does it retain the same DOI or get a new one? For example, if I cited a tutorial on Sep 21, and then it gets updated Sep 23 and its content changed in a non-backward compatible way, people reading my paper would be very confused.
The tutorials would have to be updated and re-published in a more formalized way. That is, the DOI would refer to a version of the tutorial. I'm not necessarily advocating for implementing that now, but it's something to think about.
Here's a lesson on this topic: https://reproducible-science-curriculum.github.io/publication-RR-Jupyter/aio.html
They recommend using nb_convert
to output to a format and then upload. I think we could just output to a PDF and then upload to Zenodo. I think this is worth doing once the UW-Madison tutorials go live.
New proposal: since we are planning to release the tutorials with major releases of Astropy, we can set up Zenodo to create new records / DOIs for each release of the tutorials. The one thing we need to be careful of is to make sure that everyone who has contributed to the tutorials appears, because some people may not have commits in the repository. I'll set this up and release a v3.0 version soon!
look into making a Astropy user on Zenodo to be the owner of the records.
Context is that Zenodo doesn't seem to have infrastructure for organizations in the same way as GitHub, so we think that any records created would be owned by some specific account, which would add a single point of failure if someone disappears.
The Dataverse project is similar to Zenodo in a lot of ways and seems that it does have support for group-administered sub-dataverses.
I think this should be a bit higher on our priority list. Any objections to making an Astropy Zenodo account? I'll bring up with Coordinators.
bump! I want tutorials to be citable objects! (necessary for grants that don't accept URLs in the main text)
Hey @nstarman, your ideas about how to implement citation would be welcome here.
Update: we do indeed have a team Zenodo account.
We were thinking alike, I also imagined citations would be managed by Zenodo, using their version management. Zenodo also provides badges, which can be embedded, e.g. in the tutorials. I'm not sure how we determine running authorship, as edits are made, but we can think up a good heuristic.
I just wanted to jump in here on the authorship issue: it depends on what you mean by "heuristic", but think it's pretty important for a human to have control over the author list during the publication (deposition) process. Think of a standard journal article: membership on the author list is a big deal, and the "best" membership and ordering isn't necessarily something that a machine can determine algorithmically, in general. In my opinion, treating these author lists seriously contributes to the broader effort to ensure that non-traditional academic outputs are properly valued by the community.
(This is not to exclude the possibility that the humans might decide that the best author list is something collective like "The AstroPy Collaboration".)
Author lists for regularly-released artifacts like these tutorials can be a bit "harder" than those for journal articles because you might have to decide what do to about adding and removing authors as their contribution levels vary over the long run. But regardless of how those issues are handled, I think the underlying principle should be that determining the author list is an important task to be handled by, well, the authors.