diff --git a/episodes/21-automatically-testing-software.md b/episodes/21-automatically-testing-software.md index 8e607804c..6a420e5f8 100644 --- a/episodes/21-automatically-testing-software.md +++ b/episodes/21-automatically-testing-software.md @@ -46,6 +46,19 @@ improve the predictability of a software change, make development more productive, and help us produce code that works as expected and produces desired results. +::: callout + +### Activate your virtual environment +If it is not already active, make sure to activate your virtual environment, called `venv`, +from the root of the software project directory: + +```bash +$ source venv/bin/activate # Mac or Linux +$ source venv/Scripts/activate # Windows +(venv) $ +``` +::: + ## What Is Software Testing? For the sake of argument, if each line we write has a 99% chance of being right, diff --git a/episodes/31-software-requirements.md b/episodes/31-software-requirements.md index 0a0d4e56d..143e39fda 100644 --- a/episodes/31-software-requirements.md +++ b/episodes/31-software-requirements.md @@ -20,12 +20,27 @@ exercises: 15 :::::::::::::::::::::::::::::::::::::::::::::::::: +## Introduction + The requirements of our software are the basis on which the whole project rests - if we get the requirements wrong, we will build the wrong software. However, it is unlikely that we will be able to determine all of the requirements upfront. Especially when working in a research context, requirements are flexible and may change as we develop our software. +::: callout + +### Activate your virtual environment +If it is not already active, make sure to activate your virtual environment, called `venv`, +from the root of the software project directory: + +```bash +$ source venv/bin/activate # Mac or Linux +$ source venv/Scripts/activate # Windows +(venv) $ +``` +::: + ## Types of Requirements Requirements can be categorised in many ways, diff --git a/episodes/41-code-review.md b/episodes/41-code-review.md index 694784d76..1cf142a0f 100644 --- a/episodes/41-code-review.md +++ b/episodes/41-code-review.md @@ -29,6 +29,19 @@ Software is often designed and built as part of a team, so in this episode we will be looking at how to manage the process of team software development and improve our code by engaging in code review process with other team members. +::: callout + +### Activate your virtual environment +If it is not already active, make sure to activate your virtual environment, called `venv`, +from the root of the software project directory: + +```bash +$ source venv/bin/activate # Mac or Linux +$ source venv/Scripts/activate # Windows +(venv) $ +``` +::: + ## Collaborative Code Development Models The way a team provides contributions to a shared codebase depends on diff --git a/episodes/51-managing-software.md b/episodes/51-managing-software.md index 8e372bb23..1438f36ae 100644 --- a/episodes/51-managing-software.md +++ b/episodes/51-managing-software.md @@ -34,6 +34,19 @@ it can be hard to keep track of what's done, or what needs doing, and particularly difficult to convey that to others in the team or share the responsibilities. +::: callout + +### Activate your virtual environment +If it is not already active, make sure to activate your virtual environment, called `venv`, +from the root of the software project directory: + +```bash +$ source venv/bin/activate # Mac or Linux +$ source venv/Scripts/activate # Windows +(venv) $ +``` +::: + ## Using GitHub to Manage Issues With Software As a piece of software is used,