Search results

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

by Tom Johnson on Jan 9, 2016
categories: api-doc podcasts

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.


Here are Michael’s slides:

Audio recording

Here’s the audio recording:

Listen here:

(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.

About Tom Johnson

Tom Johnson

I'm an API technical writer based in the Seattle area. On this blog, I write about topics related to technical writing and communication — such as software documentation, API documentation, AI, information architecture, content strategy, writing processes, plain language, tech comm careers, and more. Check out my API documentation course if you're looking for more info about documenting APIs. Or see my posts on AI and AI course section for more on the latest in AI and tech comm.

If you're a technical writer and want to keep on top of the latest trends in the tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me. Finally, note that the opinions I express on my blog are my own points of view, not that of my employer.