You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _extras/guide.md
+52-7Lines changed: 52 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,28 +3,73 @@ title: "Instructor Notes"
3
3
---
4
4
5
5
This page includes some tips, reminders and advice for giving this tutorial.
6
+
## Tutorial Content
6
7
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.
8
13
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).
11
16
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.
13
20
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
15
25
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.
17
48
18
49
Remind people a few days before the meeting about the pre-meeting exercises.
19
50
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.
20
65
21
66
## Tips
22
67
23
68
- Test all recipes, diagnostics and instructions in advance.
24
69
25
70
- Make sure you don't have issues with accessing the compute node via VPN or wifi,
26
71
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.
28
73
29
74
- Download a local copy of the data, just in case.
0 commit comments