Adobe Robohelp

Get new posts delivered straight to your inbox.

Subscriber count: 3,505

Stitcher radio

follow us in feedly

Want more tech comm blogs to follow? See my Tech Comm Collection of Blogs on Feedly.

Adobe Robohelp

Survey results about the possible REST API workshop

Jul 24, 2015 • api-doc

Here are the survey results from my survey I conducted about a possible REST API workshop. Although a workshop would have a lot of appeal, many people are interested in online options since they aren't located in the area where I would give the workshop.

Survey results

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.

Responses to survey about possible REST API workshop

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.

Online options?

I’m weighing different options for the online delivery of the content. There are several options:

  • Stream a live course
  • Create an e-book
  • Create an e-learning course
  • Create a series of videos

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.

follow us in feedly


Get new posts delivered straight to your inbox.

Subscriber count: 3,505

Powered by ZipRecruiter

About Tom Johnson

Tom Johnson

I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include technical writing, authoring and publishing tools, API documentation, tech comm trends, visual communication, technical writing career advice, information architecture and findability, developer documentation, 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.