Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

Sharing Your API Platform Roadmap And Telling The Story Like Readme.io

DZone's Guide to

Sharing Your API Platform Roadmap And Telling The Story Like Readme.io

Another best practice when you have a public API is to share with your users the roadmap of what is coming. If it reads like a story all the better.

· Integration Zone
Free Resource

Modernize your application architectures with microservices and APIs with best practices from this free virtual summit series. Brought to you in partnership with CA Technologies.


Sharing your platform's roadmap with the public, and your community is an often overlooked aspect of API operations but is one that can go a long way to communicate your plans for the future with your community. This is why I carved the concept out into its own research area, to help me better understand how the successful API providers, as well as API service providers are publishing, sharing, and communicating around their roadmap.

One example of this recently is out of the API documentation service provider Readme.io, who didn't just publish a nice, simple, and clean roadmap for their platform, they also told the story of the process. This is a great way to announce that you have a roadmap for the platform but is also something you should repeat as often as possible, telling the story of what you just added to the roadmap and as much detail on why.

Sharing your roadmap, and the story behind goes a long way in lowering the anxiety around what the future holds for your API consumers, something that lets them know that you care about them enough to share what you have planned. In my opinion, a roadmap for an API platform shows that you have empathy for your community, and is something I like to encourage and support, by showcasing the process of your roadmap storytelling here on my blog when I can.

The Integration Zone is proudly sponsored by CA Technologies. Learn from expert microservices and API presentations at the Modernizing Application Architectures Virtual Summit Series.

Topics:
web developement ,rest ,rest api ,documentation ,startups

Published at DZone with permission of Kin Lane, DZone MVB. See the original article here.

Opinions expressed by DZone contributors are their own.

THE DZONE NEWSLETTER

Dev Resources & Solutions Straight to Your Inbox

Thanks for subscribing!

Awesome! Check your inbox to verify your email so you can start receiving the latest in tech news and resources.

X

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}