Code for Thought
Welcome to Code for Thought, the podcast about software in research and the people behind it all. Languages: English, German, French
Code for Thought
[EN] ByteSized RSE: The README - with Julian Lenz
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
Thank you for listening! Merci de votre écoute! Vielen Dank für´s Zuhören!
Contact Details/ Coordonnées / Kontakt:
- Email mailto:code4thought@proton.me
- UK RSE Slack (ukrse.slack.com): @code4thought or @piddie
- US RSE Slack (usrse.slack.com): @Peter Schmidt
- Mastodon: https://fosstodon.org/@code4thought or @code4thought@fosstodon.org
- Bluesky: https://bsky.app/profile/code4thought.bsky.social
- LinkedIn: https://www.linkedin.com/in/pweschmidt/ (personal Profile)
- LinkedIn: https://www.linkedin.com/company/codeforthought/ (Code for Thought Profile)
This podcast is licensed under the Creative Commons Licence: https://creativecommons.org/licenses/by-sa/4.0/