From 0df6168f9267eb6a17505e331a2098f06c310a26 Mon Sep 17 00:00:00 2001 From: Ildiko Vancsa Date: Tue, 27 Jun 2017 10:25:46 +0200 Subject: [PATCH] [upstream] Add trainers' guide to the web page Move the archive items to one place on the web and add a new page for training best practices for trainers and coaches based on the experiences of the past few occasions. Change-Id: Ia0524145af0fc7afb478afe7487770a4dfe90d97 --- .../source/website/index.rst | 18 +++-- .../website/upstream-trainers-guide.rst | 67 +++++++++++++++++++ 2 files changed, 81 insertions(+), 4 deletions(-) create mode 100644 doc/upstream-training/source/website/upstream-trainers-guide.rst diff --git a/doc/upstream-training/source/website/index.rst b/doc/upstream-training/source/website/index.rst index f10f3f99..1f480756 100644 --- a/doc/upstream-training/source/website/index.rst +++ b/doc/upstream-training/source/website/index.rst @@ -15,6 +15,7 @@ OpenStack Upstream Institute accounts git upstream-archives + upstream-trainers-guide Abstract ======== @@ -105,12 +106,15 @@ Further trainers/coaches You can find the list of trainers/coaches on the `training occaisons `_ wiki page. +Best Practices for Trainers +=========================== -Archives -======== +If you're joining the training activities as a trainer, coach, or if you hold +training sessions locally you can find some tips and best practices to consider +before hosting the class provided on the :doc:`upstream-trainers-guide` page. -For more information about the past trainings and the local upstream trainings, -see :doc:`upstream-archives`. +We have collected the suggestions based on our experiences from previous +Upstream Institute trainings. Outline and online slide index ============================== @@ -170,6 +174,12 @@ Other * `Documentation Deep Dive `_ +Archives +======== + +For more information about the past trainings and the local upstream trainings, +see :doc:`upstream-archives`. + Archive of additional training activities ----------------------------------------- diff --git a/doc/upstream-training/source/website/upstream-trainers-guide.rst b/doc/upstream-training/source/website/upstream-trainers-guide.rst new file mode 100644 index 00000000..878e33ee --- /dev/null +++ b/doc/upstream-training/source/website/upstream-trainers-guide.rst @@ -0,0 +1,67 @@ +============================================ +OpenStack Upstream Institute Trainers' Guide +============================================ + +General tips for Trainers and Coaches +===================================== + +- If you are not presenting, remain engaged with the class + + - Choose a table and sit with the students to help + - If there aren't enough mentors or every table has one already, float around + the room checking in on people, especially during exercises + +- When possible, sit at a table and build connections with attendees +- Talk slowly when you are presenting - English may not be their first language +- Pause to ask students if they have questions on the material throughout your + presentation +- Ask the students questions to make sure they are engaged and understand the + material +- Join the IRC channel of the class and participate during the training + +Tips for the Class +================== + +- A week before the training begins, ensure attendees are aware of the + prerequisites when confirming attendance +- Repeat sending out a reminder to the attendees including the prerequisites + and details about the timing and venue the day before the training + + - Those who haven't seen the previous notification get a chance to prepare + - Those who forgot can still prepare + +- Get started on time even if there aren't many people in the room, just go + slowly to give people more time to show up, while still holding the interest + of the students that are there +- Use round tables if available as opposed to traditional classroom style setup + + - Organize the tables according to project interest - especially on day 2 + +- Don't give out VM image at the beginning of the first day + + - Students will play with the image instead of paying attention to the class + +- Give out swag and use competition to help keep interest and attention + +- Promote ideas for next steps after training is done; for example + + - Prior to the Summits promote Project Onboarding and other related + conference sessions + +- Use every opportunity to receive feedback, for example: + + - Could be done before end of class, for instance during the deep dive blocks + - Could be emailed survey after the class - harder to get participation + - Could be a short question as an IRC vote or something like as an exercise + between two blocks + +Tips for Exercises +================== + +- Incentivize participation +- Encourage use of IRC for answering questions or the training etherpad if an + exercise requires more space or IRC is not available +- Discuss the problems and solutions and have them explain how they got there + or why they answered what they did +- Be prepared with the deep dives that attendees have very different level of + knowledge and experience