Make your paper citable and trackable

This is a proposed method for using Zenodo to archive each release of a paper, then using the registered DOI to track mentions of the paper. However, it's making use of a process designed for archiving code repositories, so may need some alteration before it's completely appropriate for this purpose.

Instructions

1. When your paper is ready, follow GitHub's "Making Your Code Citable" instructions to archive your repository in Zenodo and generate a DOI.
2. Change the import type to "Journal Article", select the Creative Commons Attribution (CC-BY) licence - or a similar licence - and edit the list of authors to only include the real contributors to your paper.
3. Add the github.io URL of your paper to the "Related identifiers" section in Zenodo, so that mentions of this URL are (potentially) included in the metrics:
4. Add your paper's new DOI to _config.yml in your repository.
5. After a while, metrics from Altmetric should appear in the sidebar of your paper:

Potential problems

There are a few potential problems with this method:

• Any tool which tracks article metrics will need to know not only about the DOI and the Zenodo URL to which it resolves, but also the GitHub repository URL and the GitHub Pages article URL. Zenodo adds these to the DataCite deposit as alternate/related identifiers, but they may not always be recognised as such.
• The "journal article" deposit type in Zenodo may be expecting a PDF file + associated metadata, rather than a repository of "source code" for the article.