Anyone can organize a CodeRefinery workshop and teach the CodeRefinery lessons which are licensed under CC-BY. However, making it a successful workshop requires careful planning and preparation. Here we will go through practical aspects of organizing a workshop.
CodeRefinery maintains a number of workshop manuals with practical tips and checklists. We will be referring to this material below.
Set up a workshop webpage
- Go to the workshop template repository.
- Click the green “Use this template” button to import the template to your own account. Name the new repository to include a date and a location, e.g. “2019-12-24-stockholm”.
- Clone the new repository and inspect the files. Open
index.md, update some fields and commit the changes.
- Push the commits. The workshop page should now be served on GitHub Pages (e.g., https://username.github.io/2019-12-24-stockholm/).
It is very useful to ask future workshop participants to fill a pre-workshop survey before attending a workshop. The survey should probe the participants’ previous experience with different tools and programming practices, which operating system the participants use and what lessons they are most interested in.
The questions that are currently asked in the CodeRefinery pre-workshop survey are the following:
Discussion: Pre-workshop survey questions and results
- Take a moment to read the survey questions. Is there anything you would want to add? Or remove?
- How do you think the survey results look like for past workshops? Have a look at the survey repository which shows the main results, and compare them with your expectations.
To measure the long-term impact of CodeRefinery workshops it’s useful to send out a post-workshop survey. This survey can identify which topics taught in workshops are particularly useful and which have less benefits for the participants.
The survey currently contains the following questions:
There are many aspects to consider to deliver a successful workshop.
CodeRefinery maintains a number of manuals - use them when preparing a workshop.