From 62025b2c38654c8b21ce3c1f694b4fa4068a7cc3 Mon Sep 17 00:00:00 2001 From: Aleksandra Nenadic Date: Tue, 7 May 2024 16:53:28 +0100 Subject: [PATCH 1/9] Commented out VS code extra episode as it needs updating --- _config.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/_config.yml b/_config.yml index 41313fa3..213b9606 100644 --- a/_config.yml +++ b/_config.yml @@ -93,7 +93,6 @@ extras_order: - guide - common-issues - discuss - - vscode - software-architecture-extra - programming-paradigms - procedural-programming From ac26cda84e5a22c7cb6a90f2c95775743b18850e Mon Sep 17 00:00:00 2001 From: Aleksandra Nenadic Date: Wed, 8 May 2024 09:49:34 +0100 Subject: [PATCH 2/9] Change lead maintainer --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 9a78b2ab..a640639c 100644 --- a/README.md +++ b/README.md @@ -69,11 +69,11 @@ This indicates that the maintainers will welcome pull requests fixing such issue Current maintainers of this lesson (in alphabetical order) are: -* [Matthew Bluteau][matthew-bluteau] +* [Matthew Bluteau][matthew-bluteau] - Lead Maintainer for the period 1 May 2024 - 30 April 2024 * [Steve Crouch][steve-crouch] * [Kamilla Kopec-Harding][kamilla-kopec-harding] * [Doug Lowe][doug-lowe] -* [Aleksandra Nenadic][aleksandra-nenadic] (lead Maintainer for the period 1 October 2023 - 31 March 2024) +* [Aleksandra Nenadic][aleksandra-nenadic] The maintainer team aims to meet at 11:00 UK time (BST or GMT) on the fourth Wednesday each month. The meetings alternate between operations meetings and co-working sprints. Meeting notes are kept in the [Google doc](https://docs.google.com/document/d/1-SvoY_2GvlQgJnu8zfr6VnU7sev_iWZAIwBUywNSfWE/edit#). From e7def2512ef13b8737370460c8b5036940a10d1a Mon Sep 17 00:00:00 2001 From: Aleksandra Nenadic Date: Wed, 22 May 2024 11:59:15 +0100 Subject: [PATCH 3/9] Update to instructor notes --- _extras/guide.md | 22 ++++++++++++---------- 1 file changed, 12 insertions(+), 10 deletions(-) diff --git a/_extras/guide.md b/_extras/guide.md index 54168c7d..7e67826d 100644 --- a/_extras/guide.md +++ b/_extras/guide.md @@ -34,16 +34,16 @@ The course has been separated into 5 sections: - Section 1: Setting Up Environment For Collaborative Code Development - Section 2: Ensuring Correctness of Software at Scale -- Section 3: Developing Software to Meet Requirements +- Section 3: Software Development as a Process - Section 4: Collaborative Software Development for Reuse - Section 5: Improving and Managing Software Over Its Lifetime -Each section can be approximately delivered in a half-day (e.g. try to allow 4 hours per section). +Each section can be approximately delivered in a half-day but even better if you can allow 1 day per section. ## Course Delivery The course is intended primarily for self-learning -but other modes of delivery are possible -(e.g. mixing in elements of instructor-led coding-along). +but other modes of delivery have been used successfully +(e.g. fully instructor-led code-along mode or mixing in elements of instructor-led with self-work). The way the course has been delivered so far is that students are organised in small groups from the outset and initially work individually through the material. @@ -61,15 +61,15 @@ The course can be delivered online or in-person. A good ratio is 4-6 learners to 1 helper. If you have a smaller number of helpers than groups - helpers can roam around to make sure groups are making progress. -While this course can be live-coded by an instructor as well (in the earlier stages), +While this course can be live-coded by an instructor as well, we felt that intermediate-level learners are capable of going through the material on their own at a reasonable speed and would not require to code-along to the same extent as novice learners. In later stages, exercises require participants to develop code more individually so they can review and comment on each other's code, so the codes need to be sufficiently different for these exercises to be effective. -Having an instructor live-code would make everyone have exactly the same code on their machines -and would not have the same effect. +For instrctor-led mode of delivery, you can have an instructor live-code these group exercises +after learner have been given a chance to work on them as a team. A workshop kicks off with everyone together at the start of each day. One of course leads/helpers provides workshop introduction @@ -79,7 +79,7 @@ to explain what the students will be learning and doing on that particular day. After that, participants are split into groups and go through the materials for that day on their own with helpers on hand. At the end of each section, all reconvene for a joint Q&A session, feedback and wrap-up. -If participants have not finished all exercises for a section, +If participants have not finished all exercises for a section (in "self-learning with helpers" mode), they are asked to finish them off before the next section starts to make sure everyone is in sync as much as possible and are working on similar things (though students will inevitably cover the material at different speeds). @@ -87,9 +87,11 @@ This synchronisation becomes particularly important for later workshop stages when students start with group exercises. ### Helpers Roles and Responsibilities -At the workshop, everyone in the training team is a helper. +At the workshop, "self-learning with helpers" mode everyone in the training team is a helper and +there are no insturctors per se. You may have more experienced helpers delivering introductions to the workshop and sections. -Contact the course authors for intro slides you can reuse. +Contact the course authors for the section intro slides you can reuse and you can also find slides for each +section in the course repository (for intructor-led delivery mode). Roles and responsibilities of helpers include: From 6f44a312d29771b61e1fd9e18a5929db5bd73d30 Mon Sep 17 00:00:00 2001 From: Aleksandra Nenadic Date: Tue, 28 May 2024 11:09:13 +0100 Subject: [PATCH 4/9] Update _extras/guide.md Co-authored-by: Steve Crouch --- _extras/guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_extras/guide.md b/_extras/guide.md index 7e67826d..55ffb1d9 100644 --- a/_extras/guide.md +++ b/_extras/guide.md @@ -68,7 +68,7 @@ and would not require to code-along to the same extent as novice learners. In later stages, exercises require participants to develop code more individually so they can review and comment on each other's code, so the codes need to be sufficiently different for these exercises to be effective. -For instrctor-led mode of delivery, you can have an instructor live-code these group exercises +For instructor-led mode of delivery, you can have an instructor live-code these group exercises after learner have been given a chance to work on them as a team. A workshop kicks off with everyone together at the start of each day. From aa4093282e9de24c41f8ad7f394c2e0bfcaf7869 Mon Sep 17 00:00:00 2001 From: Aleksandra Nenadic Date: Tue, 28 May 2024 11:09:20 +0100 Subject: [PATCH 5/9] Update _extras/guide.md Co-authored-by: Steve Crouch --- _extras/guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_extras/guide.md b/_extras/guide.md index 55ffb1d9..d650c5e1 100644 --- a/_extras/guide.md +++ b/_extras/guide.md @@ -69,7 +69,7 @@ In later stages, exercises require participants to develop code more individuall so they can review and comment on each other's code, so the codes need to be sufficiently different for these exercises to be effective. For instructor-led mode of delivery, you can have an instructor live-code these group exercises -after learner have been given a chance to work on them as a team. +after learners have been given a chance to work on them as a team. A workshop kicks off with everyone together at the start of each day. One of course leads/helpers provides workshop introduction From 902a83757723730ffa3e613a6cb9e9a831d123b8 Mon Sep 17 00:00:00 2001 From: Aleksandra Nenadic Date: Tue, 28 May 2024 11:09:32 +0100 Subject: [PATCH 6/9] Update _extras/guide.md Co-authored-by: Steve Crouch --- _extras/guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_extras/guide.md b/_extras/guide.md index d650c5e1..c7d2bb03 100644 --- a/_extras/guide.md +++ b/_extras/guide.md @@ -87,7 +87,7 @@ This synchronisation becomes particularly important for later workshop stages when students start with group exercises. ### Helpers Roles and Responsibilities -At the workshop, "self-learning with helpers" mode everyone in the training team is a helper and +At the workshop, when using the "self-learning with helpers" delivery mode, everyone in the training team is a helper and there are no insturctors per se. You may have more experienced helpers delivering introductions to the workshop and sections. Contact the course authors for the section intro slides you can reuse and you can also find slides for each From 846853921d3a3602954ad63723937f0961d336ef Mon Sep 17 00:00:00 2001 From: Aleksandra Nenadic Date: Tue, 28 May 2024 11:09:39 +0100 Subject: [PATCH 7/9] Update _extras/guide.md Co-authored-by: Steve Crouch --- _extras/guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_extras/guide.md b/_extras/guide.md index c7d2bb03..f6231259 100644 --- a/_extras/guide.md +++ b/_extras/guide.md @@ -88,7 +88,7 @@ when students start with group exercises. ### Helpers Roles and Responsibilities At the workshop, when using the "self-learning with helpers" delivery mode, everyone in the training team is a helper and -there are no insturctors per se. +there are no instructors per se. You may have more experienced helpers delivering introductions to the workshop and sections. Contact the course authors for the section intro slides you can reuse and you can also find slides for each section in the course repository (for intructor-led delivery mode). From 630109dd8401eca4c1c916113d9d3591768ccb50 Mon Sep 17 00:00:00 2001 From: Aleksandra Nenadic Date: Tue, 28 May 2024 11:09:44 +0100 Subject: [PATCH 8/9] Update _extras/guide.md Co-authored-by: Steve Crouch --- _extras/guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_extras/guide.md b/_extras/guide.md index f6231259..22cb8cff 100644 --- a/_extras/guide.md +++ b/_extras/guide.md @@ -90,7 +90,7 @@ when students start with group exercises. At the workshop, when using the "self-learning with helpers" delivery mode, everyone in the training team is a helper and there are no instructors per se. You may have more experienced helpers delivering introductions to the workshop and sections. -Contact the course authors for the section intro slides you can reuse and you can also find slides for each +Contact the course authors for section intro slides you can reuse, and you can also find slides for each section in the course repository (for intructor-led delivery mode). Roles and responsibilities of helpers include: From 456498ff62c0d20d81ac36b5be24fd4646f81348 Mon Sep 17 00:00:00 2001 From: Aleksandra Nenadic Date: Tue, 28 May 2024 11:10:49 +0100 Subject: [PATCH 9/9] Update _extras/guide.md Co-authored-by: Steve Crouch --- _extras/guide.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_extras/guide.md b/_extras/guide.md index 22cb8cff..df9f2c36 100644 --- a/_extras/guide.md +++ b/_extras/guide.md @@ -91,7 +91,7 @@ At the workshop, when using the "self-learning with helpers" delivery mode, ever there are no instructors per se. You may have more experienced helpers delivering introductions to the workshop and sections. Contact the course authors for section intro slides you can reuse, and you can also find slides for each -section in the course repository (for intructor-led delivery mode). +section in the course repository (for instructor-led delivery mode). Roles and responsibilities of helpers include: