Devportals & Developer eXperience – Documentation in the Age of Digital Transformation
No matter the industry, most enterprise companies are today working on, or at least planning a digital transformation program. Most of these programs center around the creation of a modernized REST API infrastructure. But at the core, this transformation is about much more than technology.
Four years ago, our company transformed itself into a developer portal consultancy, specializing in API documentation and devportals (in Drupal CMS). In this talk I want to share with you what we’ve learned about developer portals, and the types of documentation you need to create a great developer experience both for internal and external audiences.
I will finish the talk with an overview of the technologies API teams currently use to build their documentation sites, describing the core principles behind Docs as Code (a methodology in which all content e.g. Markdown and Open API Specification files are stored in a GIT code repository). Lastly I will explain why traditional (c)CMSs are losing ground in this space, and discuss what we can do to keep providing value to our customers and to stay relevant.
Meet the Presenter
Kristof Van Tomme is an open source strategist and architect. He is the CEO and co-founder of Pronovix, a company that builds developer portals and documentation systems in Drupal. He’s got a degree in bioengineering and is a regular speaker at technology conferences. For a few years now he’s been building bridges between the documentation, API and Drupal communities. Several years ago he got really excited about DITA, after which he’s stayed in touch with the community.