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 ...

If you are using any SCM that allows cheap branches (like Perforce) and are following the advices from the High-level Best Practices document, you might be interested in (or already know) Laura Wingerd’s presentation Convergence vs. Divergence: Purposeful Merging with Perforce about how to converge to codelines using Merge Down, Copy Up [PDF]. I have seen it many times that a main codeline got broken because the Merge Down, Copy Up idiom was ignored. Read More ...

I’m cleaning up shelves and have got an old “SIBO SDK 2.10” which I haven’t used in years. It is a Software Development Kit for 16-Bit Psion handheld computers like Psion Series 3 or Psion Workabout. If you are interested in two floppy disks and four folders of documentation, please drop me a note.

envvc

Did you ever have the need to use different versions of Microsofts Visual C++ compiler from the command line? Did you wish you wouldn’t have to constantly call vcvars32.bat or change your environment (PATH, INCLUDE and LIB variables)? In comes a little tool called envvc.exe. It sets the environment for the chosen version and then calls any chosen executable. As additional feature it verifies that you have installed the latest service pack for the chosen version. Read More ...

Wie diese Woche bekannt wurde, gewann Kaba-Gilgen AG aus Schwarzenburg nach einem sechsmonatigen Pilotbetrieb die internationale Ausschreibung der Pariser Métro (RATP), zwei Linien mit halbhohen Bahnsteigtüren (Platform Screen Doors PSD half-height, PDF) auszurüsten. Ich gratuliere dem ADP-Team von Kaba-Gilgen für diesen Erfolg und freue mich, dass damit auch die Arbeit von Hug-Witschi den Weg nach Paris findet. Hug-Witschi hat im Auftrag von Kaba-Gilgen die Steuerung (Hardware und erste Version der Software) der einzelnen Türeinheiten entwickelt. 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