Adobe Robohelp

Get new posts delivered straight to your inbox.

Subscriber count: 3,220

Adobe Robohelp

Spec-driven Development with RAML — presentation by Michael Stowe to STC Silicon Valley chapter

Jan 9, 2016 • api-doc

In October 2015 Michael Stowe presented to the STC Silicon Valley chapter about spec-driven development, with a demo of RAML, which is an API specification similar to Swagger. Pretty much everyone who attended his presentation was impressed at how cool RAML is in making API documentation interactive. You can view Michael's slides and listen to the spec-driven development presentation recording here.

Slides

Here are Michael’s slides:

RAML for Tech Writers from Michael Stowe

Audio recording

Here’s the audio recording:

You can also download the MP3 file directly.

(Next time we’ll record the video too.)

Spec-driven development presentation description

Here’s a description of the presentation and a little bit about Michael:

Spec Driven Development isn’t just changing the way we build APIs, but even the way we share and document them. In this session we’ll take a look at what Spec Driven Development is, and how it ties developers and technical writers to the hip – helping keep documentation in sync, while reducing the work-load required to generate technical documentation, and even allows for use of modern tools such as RAML and the API Notebook that let us write and share documentation in a brand new, interactive way!

Author of Undisturbed REST: A guide to designing the perfect API, Michael Stowe has 15 years experience writing software for industries ranging from small businesses to medical associations, law enforcement, and large enterprises. His work has been published in numerous sources including Website Magazine, DZone and InfoQ, and he has spoken at a wide-variety of tech events including API Strat and API World.

To learn more, see the following:

Other resources

Previously I recorded a podcast with Michael Stowe about spec-driven development and RAML here. If API documentation and specifications are topics that interest you, definitely check out the podcast.


Get new posts delivered straight to your inbox.

Subscriber count: 3,220

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.