You’re given the task of writing a microservice AND providing a documentation in OpenAPI format. You already know that there are two main approaches:

  • code-first : write the code, using OpenAPI annotations, and then generate the OpenAPI document
  • design-first : write the OpenAPI document (a.k.a. the openapi.yaml file) and then generate the code

This article reviews the code first approach, the design-first approach will follow in a second article at a later time.


Read More ...

There are already many solutions to the “Santa Claus Problem” by John Trono1. It’s a “problem simple to understand and yet far from easy to solve”; the author’s original solution (based on semaphores) was only partly correct. The probably most known analysis of the problem was written by Mordechai Ben-Ari2, who also provided solutions in Ada95 and Java. This is the original problem description: Santa Claus sleeps in his shop up at the North Pole, and can only be wakened by either all nine reindeer being back from their year long vacation on the beaches of some tropical island in the South Pacific, or by some elves who are having some difficulties making the toys. Read More ...

Peter Steiner

Software Developer and Opinionated Citizen

Switzerland