Over a million developers have joined DZone.

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

Learn how API management supports better integration in Achieving Enterprise Agility with Microservices and API Management, brought to you in partnership with 3scale

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.

Unleash the power of your APIs with future-proof API management - Create your account and start your free trial today, brought to you in partnership with 3scale.

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 best of DZone straight to your inbox.

Please provide a valid email address.

Thanks for subscribing!

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

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

{{ parent.tldr }}

{{ parent.urlSource.name }}