Our industry, technological in nature, has far more sociological problems and challenges. The tar pit swallows yet another project, not because we couldn't figure out the technical parts, but because the people-oriented aspects had the lowest priority. Peopleware is about teams and individuals, about the people of the office - the "white collars". It's about bosses and employees, leaders and managers. It's about how, why, where, and what are our daily working activities about, how every bit of surrounding environment affects them.

It's hard to sell a software product - whether it's a library, a program, or generally speaking, a system - if it doesn't come with a top-notch manual. And keeping such manual up-to-date is not easy too. Gojko Adzic's ideas of Living Documentation to the rescue, but unfortunately they are still far from being widely adopted.

In this post I propose a different way of making Living Documentation - by testifying its contents. Dive in to find out how!

Turkish Airlines is our first choice when it comes to flying to Azerbaijan from Finland. It’s not the cheapest, but the service is great. You get good food even in economy class, and there is an entertainment system with a broad selection of movies to keep you and the kids busy. The baggage allowance is huge - 30kg for check-in and the standard 8+kg for carry-on, although I’ve never seen them put the carry-on baggage on scales.

So, what’s all the fuss about?

While "Building Microservices" is not an encyclopedia, it definitely feels like one.

Conway’s Law states that systems are designed to mirror the communication structures of the organizations that create them. How, then, can we shape an organization to produce the desired system design? Let's find out "Team Topologies: Organizing Business and Technology Teams for Fast Flow" by Matthew Skelton and Manuel Pais.

As the year 2023 was coming to an end, I finally had some time to recap "The Mythical Man-Month: Essays on Software Engineering" by Fred Brooks. The book talks about software development fallacies from software engineering and project management perspectives. However this is not "yet another book". It was first published in 1975, nearly fifty years ago! So much changed since 1975, and yet, so little! It's unbelievable that today we are still struggling with the problems that haunted us in the age of mainframes.

You smile a lot as you read the book. Programming with punch cards? A big fat machine with only 2 MB of RAM? Software documented on paper? Sure, things were different back then. But there are so many similarities! Instead of reviewing the book, I'd prefer to study these similarities, draw parallels, and find out whether things have changed for the better.

DevOps Handbook is a fantastic guide for IT organizations, that describes the ways of improving the technology value stream - the process required to convert a business hypothesis into a technology-enabled service that delivers value to the customer.

While configuring a continuous delivery pipeline for this blog, I encountered unexpected permission denials from GitHub. Was there something wrong with the setup?

Clean Architecture is the "Art of War" of the software industry. It was written by a professional who has been through many tough battles, both wins, and losses. Uncle Bob talks about timeless topics of software development that are just as applicable today as they were fifty years ago.

"Big Bang" software releases are hard on end users and developers. What can we do about it?