From 0df6168f9267eb6a17505e331a2098f06c310a26 Mon Sep 17 00:00:00 2001
From: Ildiko Vancsa <ildiko.vancsa@gmail.com>
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
<https://wiki.openstack.org/wiki/OpenStack_Upstream_Institute_Occasions#Beijing_Crew>`_ 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 <docs.html>`_
+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