Presented by Tom Johnson
The October meeting is on Wednesday, October 15, 2014 from 6:00 pm to 8:30 pm in downtown San Francisco in the SF Grove Room at the Hub in downtown San Francisco. HUB, 901 Mission St, at Fifth Street, is a short walk from the Powell Street BART/MUNI Station. HUB Bay Area is a community of people building a better world. You can learn more about the HUB community at www.HubBayArea.com. For details about reaching the location and instructions for purchasing tickets, visit www.stc-sf.org/stc-meetings.htm. Light refreshments are provided.
About the Presentation
Most of the common tools for publishing help material fall short when it comes to API documentation. Much API documentation (such as for Java, C++, or .NET APIs) is generated from comments in the source code. Their outputs don’t usually integrate with other help material, such as programming tutorials or scenario-based code samples.
REST APIs are a breed of their own, with almost no standard tools for generating documentation from the source. The variety of outputs for REST APIs are as diverse as the APIs themselves, as you can see by browsing the 11,000+ web APIs on programmableweb.com.
As a technical writer, what publishing strategies do you use for API documentation? Do you leave the reference material separate from the tutorials and code samples? Do you convert everything to DITA and merge it into a single output? Do you build your own help system from scratch that imports your REST API information?
There’s not a one-size-fits-all approach. In this presentation, you’ll learn a variety of publishing strategies for different kinds of APIs, with examples of what works well for developer audiences. No matter what kind of API you’re working with, you’ll benefit from this survey of the API doc publishing scene.
About the Presenter
Tom Johnson is a senior technical writer for the 41st Parameter, a company in the fraud detection and advertising technology space. Tom’s blog, I’d Rather Be Writing (idratherbewriting.com), is a hub for innovation and exploration in the tech comm field.
Tom lives in San Jose, bikes to work, and has four girls. You can contact him at email@example.com.