Skip to content

Exercise: a good README

Remember that the README file (usually one of README.md, README.rst, or README.txt) is often the very first thing that a user will see when looking at your project.

  • Have you seen any README files that were particularly helpful, or were not very helpful?

  • What information do you find helpful in a README file?

Consider the README.md file in the Australian 2020 COVID-19 forecasts repository.

  • What content, if any, would you add to this file?

  • What content, if any, would you remove from this file?

  • Would you change its structure in any way?