-- Day 1 Afternoon Session: Best Practices -- - **Design**: - Is the repository well structured? Are files and directories easy to find? (See [template repository](https://github.com/alan-turing-institute/reproducible-project-template)) - Does the project repository have a README file or landing page, linking to useful resources from their project? See [reference](https://the-turing-way.netlify.app/project-design/project-repo/project-repo-readme.html) - Have does this study apply collaborative approaches? Have they described it on their README? * * * - **Open**: - Is the code openly available? See [reference](https://the-turing-way.netlify.app/reproducible-research/open/open-source.html). (You can optionally look at some lines of code to see if the scripts are commented, and if the code is readable/understandable.) - Do they describe how the research data is collected, used and shared? Is the process for accessing the data clear? See [reference](https://the-turing-way.netlify.app/reproducible-research/rdm.html). (In some cases data will not be shared openly, for instance, when using sensitive data. However, those projects may provide test or synthetic data to test the code on.) - What licenses do they have? Is it permissive - would you be able to reuse it? See [reference](https://the-turing-way.netlify.app/reproducible-research/licensing.html). (Note that projects may have multiple licences). * * * - **Reproducibility**: - Is there sufficient documentation to help you reproduce the project (such as: Contributing guidelines, installation guide, User manual)? - Do they describe reproducible environment (such as: conda, docker, package management system). See [reference](https://the-turing-way.netlify.app/reproducible-research/renv.html) - What other reproducible tools and practices does this project use? (based on the presentation this morning). See [Guide for Reproducibility](https://the-turing-way.netlify.app/reproducible-research/reproducible-research.html). * * * - **Ethics**: - Why is this an important study for society? Does it describe ethical implication of their work? See [reference](https://the-turing-way.netlify.app/ethical-research/ethics-committees.html) - What aspects of this work may have potential harm/loss in the society if the study does/did/will not address it? * * * -- Day 2 Afternoon Session: Brainstorming Open Infrastructure Roles -- 1. **Which different infrastructure roles (if any) can you identify as having been involved?** - Ethics,Data Science,Software Engineering,Research Application Managers, Policy - Can you identify any roles that *should* have been involved? * * * 2. **What work was involved for each role?** - How to collaborate? - Stakeholder mapping / engagement? - What stages of the project does each role need to be involved? - Oversight / Organization * * * 3. **What skills would you need for each role?** - Think about: - Open, reproducible research - Domain Knowledge - Internal/External Communication - Management / Leadership - Strategy / Vision * * * 4. **What resources would you need for the project to succeed?** - List priorities - Estimate scale of project resources - Funding * * * 5. **How would you improve the case study if you were to do it again?** * * *