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 is the second article in a series and reviews the design-first approach, the code-first approach was the subject of the first article.


Read More ...

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

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.

Peter Steiner

Software Developer and Opinionated Citizen

Switzerland