Getting Started with Project Design#

Thinking about reproducibility from the start of your project is the best way to save time and get the most out of the available tools. Creating connections between data, code, methodology, as well as diverse collaborators, can seem like a daunting task if it has not been planned from the beginning (see this illustration of the Research Cycle). By documenting and sharing project workflows and processes for research and researchers, we can ensure the sustainability and reusability of research for both developers and future users. In addition, planning your project at the start can help you make sure that you are meeting any funder requirements.

A human-centered approach in the context of the research project can lead to a better development process, maintenance, and future extension of our work. Furthermore, it will help improve the quality of future project design as we can learn lessons from what worked and what can be improved.

Note

Top three ‘selfish’ reasons to use project design practices

  1. Saves time: once the project is designed and all the connections between different parts of research can be organized with little effort.

  2. Makes your research openly available: having your research open from the start can help others working in similar subjects or starting research.

  3. Get people interested: you can get people to help you from the start since your project is documented and is easy to share.

Setting Expectations Explicitly#

Project design practices help provide guidance and set clear expectations by explicitly communicating norms and empowering project members at different levels of hierarchy to collaborate equitably. Project design for reproducible research encompasses a variety of aspects, starting from defining the purpose, main research questions, expected users or target audience, available resources, and skills required in the project. It also requires researchers to explore the possible outcomes, plans to address expected challenges or risks, ensure diversity of stakeholders, and reduce possible barriers to participation.

Project design practices help all stakeholders to be certain about their roles and responsibilities, skill requirements, environment, and research setup they want to create for their collaborators, values they want to promote, and how they can achieve their goals collaboratively.

Organising Files and Documents#

Create a shared repository to allow easy access to information and different documents related to your project. A project repository can be openly available if you are developing an open source project, or can be shared only with your collaborators. In the chapter Creating Project Repositories, you can learn about how to set up a repository with key documents like a landing page, contribution guidelines and communication pathways.

Start by documenting your vision, mission, goals and roadmap in a README file (see the Landing Page - README File chapter), followed by a description of resources and norms for collaboration and communication. In the next chapter, we discuss how project design enables good communication and collaboration in research. In the subsequent chapters, we describe different methods and tools for ensuring research reproducibility.

Chapter Tags: This chapter is curated for the Turing Data Study Group (turing-dsg).