Earlier this week I asked for your feedback about a possible REST API workshop I was thinking about providing. If you would like to view the answers from the survey, you can read them here or from the screenshot below.
In summary, it seems that there is a substantial interest in a REST API workshop (particularly on a Saturday morning or weeknight), but since most people aren’t located near Mountain View, California, more people are interested in online options than in-person workshops.
Additionally, although most people are interested in REST APIs, people are also interested in learning about other APIs as well.
Most people would pay about $99 for the workshop, and the duration should last about 4 hours. The travel time was a factor in the workshop duration. Few people are willing to travel great distances for a shorter workshop. If they have to increase the travel time, the workshop duration should be longer, such as 8 hours.
I’m weighing different options for the online delivery of the content. There are several options:
The e-learning courses are popular now. The number of online learning platforms has exploded. Some of the platform options include Udemy, Audacity, Fedora, Moodle, Braincert, Code Academy, Pluralsight, Udacity, and dozens more.
Just this week Peter Gruenbaum launched his second part of his Learn API Technical Writing: Part 2 on Udemy. And Scriptorium launched Learning DITA, an e-learning course that teaches you DITA, through their own WordPress e-learning platform.
In contrast to courses, e-books and videos are also an option. Safari Books Online remains one of my favorite learning options because with books, you can adjust the pace of your study based on your technical level. If you’re a beginner, you can go slow and reread the same paragraphs multiple times, or ramp up on needed terms and concepts at a snail’s pace. Advanced users can skip ahead to the parts they have questions about.
(Safari’s library aren’t necessarily ebooks — they’re more like online books — but the concept is similar.)
Lynda.com presents a series of videos, one after the other. I like Lynda.com because the video format forces the instructor to show how to do tasks. You won’t get bogged down in concepts and abstracts. You focus on doing things.
Overall, I’m leaning towards both an e-book and series of videos. I also plan to hold a workshop in Mountain View, but I want to repurpose the content into the e-book and videos as well.
Get new posts delivered straight to your inbox.
I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include the following technical communication topics: Swagger, agile, trends, learning, plain language, quick reference guides, tech comm careers, and certificate programs. I'm interested in information design, API documentation, visual communication, information architecture and findability, and more. If you're a professional or aspiring technical writer, be sure to subscribe to email updates using the form above. You can learn more about me here. You can also contact me with questions.