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!

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.

Doing things right doesn't matter unless you do the right thing. "Specification by Example" by Gojko Adzic is about delivering the right software. Adzic has interviewed many successful teams and discovered that their ways of software development are quite similar. These ways or processes are based on a close collaboration between all the parties, including business representatives. It begins by understanding the business goals. It continues with creating a specification and utilizing it for software development and verification. It is finalized by providing living documentation which reflects the current software state and behaviour.

"Specification by Example" helped me to understand how to do behaviour-driven development (BDD). It is an excellent reading for a software craftsman.

Welcome to the third part of the article series, which cover principles of Hexagonal architecture, Dependency Injection, Domain-Driven Design and applies these all to Python and Django application design.

Refactoring is a book by Martin Fowler about what a fellow developer might describe as "a process of improving the code quality."

I highly recommend this book to software professionals who want to improve and formalise their refactoring skills.

Welcome to the second part of the article series, which cover principles of Hexagonal architecture, Dependency Injection, Domain-Driven Design and applies these all to Python and Django application design.

It might be very convenient to use the same fixtures in test setup and assertions. This practice though is not as good as it looks like at first glance.