A full list of tutorials can be found in the guides/ folder.
It’s a way to help develop expertise, reflect on what you’ve learned as part of your explorations with the web programming, and to contribute something useful back to the class as a whole.
Once during the semester, each person will be asked to prepare, publish and present a technical tutorial. The goal of the tutorial should be to introduce a tool, technique, component, library, service etc. that will help other students with their projects. The tutorial should be succinct but complete and provide a step-by-step introduction to a topic relevant to the course.
You’ll publish the tutorial in the course repo
You can choose what tutorial you’d like to prepare or work with the instructor to find a a suitable topic. Tutorials should be proposed before the deadline to a) take your interests and abilities and b) needs and suitability for the course into consideration.
Not every tutorial will require the same level of effort. More advanced students will be expected to produce more complex or involved tutorials, and may be expected to create custom code or solutions to contribute with the tutorial. In other cases, it may be as simple as recording a screencast and writing some clear instructions. Again, this will be negotiated with the instructor.
10% of your grade is given for a guide. Full details on grading for the guide can be found in the Grading, Feedback and Policies section
A good place to start your tutorial from is:
Your tutorial could be about:
Create your tutorial as a new .md in your forked copy of the course repo. You’ll find a template in your student folder.
Then, issue a pull request for your tutorial when it’s ready.
Your tutorial can take a few different formats - it could contain a video, have some code samples, include images, and/or a written description.
While the format may vary, the goal is to write a succient, clear and easy-to-follow guide of how to get something working in Sinatra / to build a bot-based or chat-based service.
The tutorial should be reasonably brief (around 1-2 pages), sensibly illustrated with images and video and be written with the class in mind. Basically, how would you introduce this thing quickly to the person sitting next to you?
As part of your tutorial you will probably need to: