Author Archive

How we build our API documentation

API DocumentationIf you have ever used APIs you know that good documentation is important. It should also always be up-to-date. In this post I’m not going to discuss how to write documentation and what is required, but rather which tools we use to get the documentation updated as quickly as possible on our developer portal (developer.leaseweb.com).

We employ a number of different tools to help with the process.

  1. RAML (raml.org)

Good documentation starts with good specifications. For this we have decided to use RESTful API Modeling Language (RAML) (created by MuleSoft), together with tools like raml2html (https://github.com/raml2html/raml2html) for creating HTML. Using templates, we can create the HTML as we need it for further processing. Within the RAML specifications, we give descriptions to each endpoints that will become the documentation a user can see on the site.

We already had experience with RAML, which made our choice easy, but there are other tools/specifications around that can do the same. Swagger (swagger.io) is probably the largest and most supported framework around.

Read the rest of this entry »

LeaseWeb on Twitter

TechSummit will host speakers from Lyft, Best Buy and more. Signup now for the best in the industry - limited number lsw.to/lkZ

test Twitter Media - TechSummit will host speakers from Lyft, Best Buy and more. Signup now for the best in the industry - limited number https://t.co/zTJUhw9xxx https://t.co/1d9ctuIxqe

TechLunch September edition: Don't miss Leaseweb's Arnoud Vermeer explain "Scaling Infrastructure Behind the Scenes" lsw.to/lkg

test Twitter Media - TechLunch September edition: Don't miss Leaseweb's Arnoud Vermeer explain "Scaling Infrastructure Behind the Scenes" https://t.co/UKVBlPTGMB https://t.co/PItddSz7gG

If not you then who? If not now, then when? lsw.to/lkE #Leaseweb #Opportunity

test Twitter Media - If not you then who? If not now, then when? https://t.co/oMSThqDWe0 #Leaseweb #Opportunity https://t.co/E9FnLiDIU8

Cyberattacks: How to understand the ongoing threat and how to prepare against it lsw.to/lkt