Spec-driven Development with RAML -- presentation by Michael Stowe to STC Silicon Valley chapter
Slides
Here are Michael’s slides:
Sponsored
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
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, agent skills, tech comm careers, and more. Check out my AI courses for more on the latest in AI and tech comm. If you're looking for info about documenting APIs, see my API documentation course.
If you're a technical writer and want to keep on top of the latest trends in tech comm, be sure to subscribe to email updates below. You can also learn more about me or contact me.
Finally, I want to note a couple of things. I usually write the first drafts of my posts myself and then use AI to improve accuracy, clarity, and detail in places, so my writing is a mix of human and AI. (Hopefully that's not too off-putting.) Also, the opinions I express on my blog are my own perspectives, not those of my employer.