[Proposal]: Good practices in research software development

[svenvanderburg]

1. Lesson Topic

Good practices in research software development

2. Lesson Language

English

3. Draft materials

https://github.com/esciencecenter-digital-skills/good-practices-lesson

4. Requirements for existing materials

• do your lesson materials conform to our Code of Conduct?
• are your materials already on GitHub and do they use The Carpentries lesson template or The Carpentries Workbench? (you can visit the Workbench tutorial to learn more about how to use our lesson infrastructure).

5. New repository creation

• I need a new repository created

6. Transfer existing repository

• my lesson meets both criteria in part 4 and I would like to transfer the repository to The Carpentries Incubator

7. Collaborators

@lyashevska @svenvanderburg

8. Info/Questions

Heavily inspired by CodeRefinery, but started to deviate too much.

Syllabus:
Code Documentation

• In-code documentation
• Readme files
• Writing documentation with sphinx and ReadTheDocs or Github pages

Modular Code Development

• How can you create blocks of code that can be reused?

Testing

• Introduction to testing: motivation, unit testing, integration testing
• Writing tests with pytest

Continuous Integration

• Introduction to Continuous Integration
• Setting up Continuous Integration with Github Workflows
• Linting and automated testing

[tobyhodges]

This looks very cool, thanks for sharing @svenvanderburg.

Before I set things up to allow the lesson to be transferred, please could you add some more attribution to Code Refinery, e.g. mentioning and linking to the relevant lesson(s), on the repository README and in index.md?

[svenvanderburg]

Yes indeed that is something we should have done earlier, and the Readme should get an update anyway. I opened 2 issues:

• Update README good-practices-lesson#38
• Add more attribution to Code Refinery good-practices-lesson#39

Also see coderefinery/reproducible-research#266

Regarding timeline: we will probably pick this up around December/January.

[svenvanderburg]

@tobyhodges carpentries-incubator/good-practices-lesson#38 and carpentries-incubator/good-practices-lesson#39 are done. If you like the updated README and landing page we can proceed to the transfer.

[svenvanderburg]

@tobyhodges can you give us an indication when you think this will be picked up?

[tobyhodges]

Thanks for your patience @svenvanderburg. I have added you both to the newly-created @carpentries-incubator/good-practices-research-software-maintainers team and you can now make the repository transfer. When that is done, I will make sure that you retain the appropriate level of access to the repository: you will be given full administrative rights, and the collaborators you listed above will be given "Maintain" privileges.

I will leave this issue open until the transfer has been completed. If you have any questions about the process, or if you run into any trouble, please post back here and I will be happy to help you.

[svenvanderburg]

I transferred the lesson: https://github.com/carpentries-incubator/good-practices-lesson Can you give us the access rights?

[tobyhodges]

Thank you @svenvanderburg. I will close this issue now that the repository is set up and you have the appropriate access. I will still receive notifications so please post back here if you have any questions!

[svenvanderburg]

Great, thank you so much @tobyhodges 🙏