Skip to content

Commit 9975c0e

Browse files
committed
updated guide for instructors
1 parent 4fb7452 commit 9975c0e

File tree

1 file changed

+52
-7
lines changed

1 file changed

+52
-7
lines changed

_extras/guide.md

Lines changed: 52 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,28 +3,73 @@ title: "Instructor Notes"
33
---
44

55
This page includes some tips, reminders and advice for giving this tutorial.
6+
## Tutorial Content
67

7-
## Preparing the meeting.
8+
Well ahead of the planned tutorial date, please go over the available
9+
tutorial material
10+
in your own time at least once to note specifics such as areas where
11+
your cohort may need extra time, any changes you want to make or
12+
additional examples you would like to include.
813

9-
Once you've agreed to a date, and attendees have signed up, send them a link to
10-
the pre-tutorial instructions page (setup.md).
14+
If you want to add to or adapt the material, you can create your own copy to
15+
modify by forking the repository. See here for a guide on [how to fork a repository](https://docs.github.com/en/enterprise/2.13/user/articles/fork-a-repo).
1116

12-
Plan for the tutorial to last two hours. If you do go longer, please include a comfort break.
17+
Please use our guide for [Contributing](CONTRIBUTING.md) when creating your
18+
own material just in case you would like to add to the current
19+
repository in the future.
1320

14-
Coffee and biscuits always goes down well with participants.
21+
Once you are satisified with the material you would like to use and have
22+
an estimate of the time required, please proceed with meeting logistics.
23+
24+
## Meeting Logistics
1525

16-
Remember to email attendees in advacnce to set up conda and work through the set up page.
26+
Decide if the tutorial will be held on site or online. If on site, make
27+
sure of venue availability before finalizing the date. If online, set up connection details.
28+
29+
Once you have agreed to a date, and attendees have signed up, send them an email
30+
with the following information:
31+
- a link to the [pre-tutorial instructions page](setup.md)
32+
- a contact email address so they can post any questions that arise during setup
33+
- Venue details (if on site) or meeting connection details (if online).
34+
35+
Also allow for sufficient time to get access to any
36+
accounts etc. which could take more than a few days in some cases (a good
37+
thumb rule is to have the time to send a reminder email a few days after
38+
the first email,
39+
so that participants will still have time after the reminder to complete
40+
setup).
41+
42+
Plan for the tutorial to last at least two hours (this could vary based on
43+
your choice of modules and any changes you have made to the tutorial).
44+
If you do go longer, please include comfort breaks as needed.
45+
46+
If more than one person will be conducting the tutorial, discuss ahead
47+
and decide who will handle each component for a smooth flow of material.
1748

1849
Remind people a few days before the meeting about the pre-meeting exercises.
1950

51+
If conducting the tutorial on site, confirm room bookings and check for
52+
internet connectivity or firewall issues
53+
at the venue. Coffee and biscuits also usually go down well with participants!
54+
55+
If conducting the tutorial online, have a backup plan for failed or
56+
poor internet connections. This could involve sending participants
57+
some of the material or previously recorded meeting videos ahead of time.
58+
Establish rules for questions, microphone and video usage before starting the
59+
meeting. Send meeting connection details (Zoom/Teams etc.) ahead of time and
60+
the day before the meeting.
61+
62+
Have a feedback form ready if you would like attendees to send you feedback.
63+
Request that they do so at the end of the tutorial and send it out as soon after
64+
the tutorial as possible.
2065

2166
## Tips
2267

2368
- Test all recipes, diagnostics and instructions in advance.
2469

2570
- Make sure you don't have issues with accessing the compute node via VPN or wifi,
2671

27-
- Check to copmputing service for any planned downtime or potential interuptnios.
72+
- Check with your computing service for any planned downtime or potential interuptions.
2873

2974
- Download a local copy of the data, just in case.
3075

0 commit comments

Comments
 (0)