Merge pull request #361 from carpentries-incubator/anenadic-instructor-notes

Update to instructor notes

Author: anenadic

_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 instructor-led mode of delivery, you can have an instructor live-code these group exercises 
+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
@@ -79,17 +79,19 @@ 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).
 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, 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 intro slides you can reuse.
+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 instructor-led delivery mode).
 
 Roles and responsibilities of helpers include: