And in this last episode of our first ByteSized RSE season, we talk about the README file. My guest in this episode is Julian Lenz from the University in Swansea, UK who will take us through the importance of READMEs, what should go into them and at what stage should you create one (spoiler alert: a.s.a.p.).

Here are a few links you might find useful.
Example READMEs and templates

• https://github.com/matiassingers/awesome-readme a list of example READMEs
• https://dev.to/documatic/awesome-readme-examples-for-writing-better-readmes-3eh3 a guide for writing better READMEs
• https://github.com/matiassingers/awesome-readme#articles more articles on how to write READMEs
• https://github.com/othneildrew/Best-README-Template templates for READMEs
• https://github.com/Louis3797/awesome-readme-template another README template

Background

• https://www.gnu.org/prep/standards/ GNU Coding standards. READMEs are mentioned in chapter 7.3
• https://medium.com/@NSomar/readme-md-history-and-components-a365aff07f10 a history of READMEs
• https://daringfireball.net/projects/markdown/ the MARKDOWN format

Byte-sized RSE is presented in collaboration with the UNIVERSE-HPC project.
https://www.imperial.ac.uk/computational-methods/rse/events/byte-sized-rse/
ByteSized RSE link to Imperial College

Support the showThank you for listening and your ongoing support. It means the world to us!
You can also support our efforts by leaving a rating or review.
Follow or contact us on

• Email mailto:code4thought@proton.me
• Patreon https://www.patreon.com/codeforthought
• Slack (ukrse.slack.com): @code4thought
• Mastadon: @code4thought@fosstodon.org
• LinkedIn: https://www.linkedin.com/in/pweschmidt/

This podcast is licensed under the Creative Commons Licence: https://creativecommons.org/licenses/by-sa/4.0/