Skip to content

Latest commit

 

History

History
39 lines (30 loc) · 1.61 KB

STANDARD.md

File metadata and controls

39 lines (30 loc) · 1.61 KB

REMARK Guidelines

A REMARK refers to an open git repository that is indexed in this repository with appropriate metadata.

Submitting a REMARK

To index the repository as a REMARK, please file a pull request in this repository.

The PR should add a link to the repository to the Catalog (currently, in the README).

The REMARK Standard

.
|-- reproduce.sh
|-- CITATION.cff
`-- binder
    `-- environment.yml

The REMARK's repository must:

  1. Have a tagged release, the last commit before including it as a REMARK should be tagged with a 1.0 release.
  2. In that repository at that release, there must be:
  • There must be a binder/ directory containing an environment.yml:
    • an environment.yml file with pinned dependencies
  • A reproduce.sh script that
    • Installs the requirements
    • Runs and reproduces all the results
  1. Include a valid CITATION.cff document with bibliographic metadata for the repository.
  2. Subset of results that you are claiming to be reproducible.
    • This could be specified as a directory?

It is strongly recommended to include:

  • If reproduce.sh takes longer than a few minutes, a reproduce_min.sh that generates some interesting subset of results within a few minutes
  • A Jupyter notebook that exposits the material being reproduced.

A maximalist REMARK (the extra stuff is completely optional) includes:

  • A reproduce_text-etc.sh that generates the text
  • A dashboard that creates interactive versions of interesting figures