Documentation, nginx and communication between microservices…

Hello there, with a slight delay I am back with the weekly newsletter. I hope you are having a great weekend. As always, I am looking forward to your feedback via twitter/__florian.

„What nobody tells you about documentation” by Daniele Procida

Documentation is always a let’s say – neglected topic in the daily work in an engineering team. This great article splits up the big topic of “documentation” into four kinds: Tutorials, How tos, explanations and references. This allows you to think differently about what you and your team actually need and how to deal with each type of documentation. Very interesting read.

nginx (Architecture of Open Source applications) by Andrew Alexeev

So this article is already a few years old, but it gives great insight into the software architecture of the infamous nginx webserver. I highly recommend this article, as it does not only give you a better understanding about nginx, but also great insights into how to architect a highly concurrent system, that performs as well as nginx.

„Communication in a microservice architecture” on microsoft.com

Even though this article is part of the .NET documentation, it gives a very good high level view over the available options for inter service communication in a microservice architecture. A very good reminder about the options we have to orchestrate the communication.

„Architecture decision records” (github)

ADR introduces the concept of keeping a log of architecture decisions, that have been made throughout the project and store the information next to the code. It makes it super easy to keep track of decisions over a long period of time, with limited effort for recording. I have to admit that I never used it myself, but I would love to hear your experiences!

There we go. I hope you got some value out of these links and I am looking forward to your feedback.

Have a great one,
Florian

This website does not use any tracking or feedback mechanism. Instead, I would love for you to get in touch with me to let me know if you liked it or if you have any suggestions or questions.