DZone
Integration Zone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Over 2 million developers have joined DZone.
Log In / Join
  • Refcardz
  • Trend Reports
  • Webinars
  • Zones
  • |
    • Agile
    • AI
    • Big Data
    • Cloud
    • Database
    • DevOps
    • Integration
    • IoT
    • Java
    • Microservices
    • Open Source
    • Performance
    • Security
    • Web Dev
DZone > Integration Zone > Sharing Your API Platform Roadmap And Telling The Story Like Readme.io

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.

Kin Lane user avatar by
Kin Lane
·
Aug. 30, 16 · Integration Zone · Opinion
Like (5)
Save
Tweet
3.50K Views

Join the DZone community and get the full member experience.

Join For Free


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.

API

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

Opinions expressed by DZone contributors are their own.

Popular on DZone

  • Acceptance Tests in Java With JGiven
  • It's Official! Fat Arrows in JavaScript!
  • The Digital Finance Revolution, Open Banking, and APIs
  • Fun With Modules

Comments

Integration Partner Resources

X

ABOUT US

  • About DZone
  • Send feedback
  • Careers
  • Sitemap

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • MVB Program
  • Become a Contributor
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 600 Park Offices Drive
  • Suite 300
  • Durham, NC 27709
  • support@dzone.com
  • +1 (919) 678-0300

Let's be friends:

DZone.com is powered by 

AnswerHub logo