Lessons learned

Impressions

  • JupyterHub is a powerful educational tool. With the release of JupyterLab 4 and real-time collaboration at v1.0.0, I can envision JupyterHubs becoming even more useful, for example enabling real-time collaborative technical support, or for small group exercises to be done in a shared notebook.
  • The CryoCloud JupyterHub performed flawlessly and did everything we need. I was surprised how smooth it was for attendees from around the globe to use QGIS in a virtual desktop environment.
  • Our attendees were very engaged, and this made the workshop very rewarding and lots of fun to administrate.

Changes we’d like to make

  • The material we developed technically fit in the schedule, but we wanted to provide more time for attendees to do hands-on work. Either increase the time for the material, or cut some material.
  • When sending 5-minute warnings at the end of breakout group exercises, ask attendees to commit their work to GitHub now, regardless of whether it’s done.
  • For the Symbolizing datasets together exercise, it would be helpful to include a deliverable in addition to the .qml files. Maybe a screenshot and/or discussion post. This would make it easier for us to review the outcomes from this exercise.
  • We should have prescribed a more clear structure for file names/structure in git repos. It can be initially hard to tell which notebooks correspond to each exercise in groups’ repos.
  • Archive all workshop materials after completion. We had a temporary workspace (qgis-data) which had faster storage that allowed e.g., QGIS to more quickly access data in QGreenland that participants used and stored some data on. This directory got cleaned-up after the workshop.

Tips and tricks

  • Let people join their own breakout rooms; trying to predict what e-mail people will join Zoom with and pre-configuring breakout rooms turned out to be a time sink. Inevitably, some will join from their phone, not sign in, etc. resulting in spending time manually setting up breakout rooms.
  • One problem we encountered was copy/paste from the clipboard does not work between the remote desktop and the user’s local desktop environment. In order to get around this limitation, workshop participants resorted to using a text file for transferring text between the remote and local desktop environments. For example, if a user wanted to move text from their local desktop to the CryoCloud desktop environment, they would save that text to a file (e.g., copy.txt) and then transfer that file to CryoCloud (either by uploading the file through the file browser interface in JupyterLab or using JupyterLab’s built-in file editor).

Run of show

We created run-of-show documents in Google Docs that we could collaboratively edit to manage team checklists and roles.

TODO: Link read-only copies