Skip to content

Instantly share code, notes, and snippets.

@danielecook
Forked from PurpleBooth/README-Template.md
Last active January 5, 2020 22:13
Show Gist options
  • Save danielecook/94272f387d3366070d2546e2eadefe57 to your computer and use it in GitHub Desktop.
Save danielecook/94272f387d3366070d2546e2eadefe57 to your computer and use it in GitHub Desktop.
A template to make good README.md for a scientific or data analysis project

Project Title

One Paragraph+ describing the project goes here. For example: This is a README template you would use to describe a scientific or data analysis project. Provide an overview of the goals of the project, how data was obtained, and other important details others or you in 6 months should be aware of.

Data

Describe the dataset in more detail here if necessary

Data Contact

List a data contact that can be contacted for inqueries regarding archiving and/or removal of data. Two methods of contact should be left, including one that is outside / external to the current institution.

  • Daniel E. Cook danielecook@gmail.com - Contact for inqueries regarding data located in primary/data/folder.
  • Expiration Date - YYYYMMDD - Data can be (deleted | archived) <-- choose one

Most scripts / analysis can be left as they often do not take up substantial amounts of space, so it is important to describe in detail how data should be handled.

Getting Started

What are the primary analysis scripts/starting points? How would the analysis be rerun?

Give an example

Requirements

A step by step series of examples that tell you how to get a development/analysis env running

Say what the step will be

Give the example

And repeat

until finished

End with an example of getting some data out of the system or using. It is also worth listing what the requirements are.

Publications

List references with links to publications this analysis was used for.

The genetic basis of natural variation in Caenorhabditis elegans telomere length
Cook DE, Zdraljevic S, Tanny RE, Seo B, Riccardi DD, Noble LM, Rockman MV, Alkema MJ, Braendle C, Kammenga JE, Wang J, Kruglyak L, Fe ́ lix MA, Lee J, Andersen EC.
2016. Genetics 204:371–383. DOI: https://doi.org/10.1534/genetics.116. 191148, PMID: 27449056

Contributing

Details regarding how to contribute. Coding style conventions, use of tests, etc.

Notes

Additional notes / precatuions / etc. to make users aware of.

Authors

List all authors, their contributions, and how to contact; Preferably an internal and external form of contact.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

  • Hat tip to anyone whose code was used
  • Inspiration
  • etc
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment