The RESTful API Modeling Language (RAML) is a YAML-based language that is used for describing REST(ful) APIs. I like the RAML syntax because it's text based, versatile, and easy to use. However, when I publish a REST API, I must provide readable API documentation or no one will use my API. This blog post describes […] Read more

One of the misconception that is often associated with agile software development is that agile teams won’t write any technical documentation. I assume that this misconception is so common because the agile manifesto states that we should value working software over comprehensive documentation. Also, since some of us have experience from writing long technical documents […] Read more

We have just started a new project to a customer who sells widgets. This customer is the leading widget provider of the whole world so the project can either make or break us. The project uses agile methods, and the Product Owner has come to talk with the team. He is going to describe the […] Read more

Each week I write a blog post which describes what I learned that week. I write these blog posts for two reasons. First, I want to keep track of my personal development and writing regular blog posts is a great way to do it. Second, I want to share my findings with you. I hope […] Read more

Each week I write a blog post which describes what I learned that week. I write these blog posts for two reasons. First, I want to keep track of my personal development and writing regular blog posts is a great way to do it. Second, I want to share my findings with you. I hope […] Read more