Open sourcing my workshop: an experiment
This is an experiment I’ve been thinking about for some time now. I have absolutely no idea how it will turn out, but hey, there’s only one way to find out!
What is an open source workshop?
I have recently created a workshop and delivered this with reasonable success to an audience of Dutch testers. I have received and processed the feedback I got that day, and now it’s time for the next step: I’m making it open source. This means that I’m giving everybody full access to the slides, the exercises and their solutions and the notes I have used in the workshop. I’m hoping this leads to:
- Feedback on how to further improve the contents and the presentation of the workshop
- More people delivering this workshop and spreading the knowledge it contains
What is the workshop about and who is it for?
The original version of this workshop is an introduction to RESTful web services and how to write tests for these web services using REST Assured. It is intended for testers with some basic Java programming skills and an interest in web service and API testing. However, as you start to modify the workshop to your personal preferences, both the contents and the target audience may of course change.
A simplified outline of the workshop looks like this:
- An introduction to RESTful web services and their use in modern IT applications
- An introduction to REST Assured as a tool to write tests for these services
- Setup of REST Assured and where to find documentation
- Introduction of the application under test
- Basic REST Assured features, Hamcrest and GPath
- Parameterization of tests
- Writing tests for secure web services
- Reuse: sharing variables between tests
The workshop comes with a couple of small (this workshop was originally designed to be delivered in 3 hours) sets of exercises and their solutions.
Prerequisites and installation instructions
As stated before, the workshop participants should have an interest in test automation, some basic Java (or any other object oriented programming language) knowledge as well as a grasp of the contents of web services.
The exercises are contained within a Maven project. As REST Assured is a Java library, in order to get things working you need a recent JDK and an IDE with support for Maven. Since TestNG is used as a test runner in the examples, your IDE should support this as well (see the TestNG web site for instructions), but feel free to rewrite the exercises to use your test framework of choice. I just happen to like TestNG.
So where can I find all these goodies?
That’s an easy one: on my GitHub repo.
How can I contribute?
I hope that by now you’re at least curious and maybe even enthusiastic about trying out this workshop and maybe even thinking of contributing to it. You can do so in various ways:
- By giving me constructive feedback on either the concept of an open source workshop, the contents of this particular workshop, or both.
- By spreading the word. I’d love for you to let your friends, colleagues or anyone else in your network know that this workshop exists. The more feedback I get, the better this workshop becomes.
- By actually delivering the workshop yourself and letting me know how it turned out. That’s a great form of feedback!
Interesting, but I have some questions…
Sure! Just submit a comment to this post or send me an email at firstname.lastname@example.org. Especially if you’re planning to deliver the workshop, but feel you are stuck in some way. Also, please don’t forget to share the raving reviews you got (or stories on why and where you got booed off the stage..)! Remember that this is an experiment for me too, and if it turns out to be a successful one I definitely will create and publish more of these workshops in the future.
And on a final note, if you’re interested in having this workshop delivered at your organization, but you don’t feel comfortable doing it yourself, please let me know as well. I am happy to discuss the options available and work something out."