Testified Documentation

Posted on 29 September 2024 in Articles • Tagged with programming, python, documentation, tests, specification, BDD, collaboration, cucumber • 5 min read

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!

Testified documentation diagram

Continue reading

The dark patterns of seat selection in Turkish Airlines

Posted on 17 August 2024 in Articles • Tagged with flying, turkish-airlines, dark-patterns • 4 min read

Dark Turkish airlines logo

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?


Continue reading

Building Microservices - more than just another "microservices book"

Posted on 09 July 2024 in Books • Tagged with book, review, microservices, architecture • 2 min read

Building Microservices book cover

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


Continue reading

Teams Topologies - Book Review

Posted on 23 March 2024 in Books • Tagged with book, review, architecture, teams, software development • 6 min read

"Teams Topologies book cover"

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.


Continue reading

The Mythical Man-Months - thoughts

Posted on 19 March 2024 in Books • Tagged with book, review, software development, programming, management • 22 min read

"Then Mythical Man-Months" by Frederic Broogks book cover

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.


Continue reading

The DevOps Handbook - review

Posted on 11 August 2023 in Books • Tagged with book, review, devops, software development, programming • 3 min read

"DevOps Handbook cover"

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.


Continue reading

The curious case of denied repository access in Github Actions workflow

Posted on 01 June 2023 in Articles • Tagged with programming, blog, pelican, git, github, actions, ci/cd, access denied • 4 min read

Intro image for the article

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


Continue reading

Clean Architecture - book review

Posted on 18 May 2023 in Books • Tagged with book, review, programming, architecture, clean code, clean architecture • 6 min read

"Clean Architecture" book cover

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.


Continue reading

Good practices: Software deployment and feature releases

Posted on 03 April 2023 in Articles • Tagged with good practices, software, deployment, release • 2 min read

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


Continue reading

Specification by example - book review

Posted on 21 February 2023 in Books • Tagged with book, review, programming, specification, requirements, BDD, collaboration • 4 min read

"Specification by Example" by Gojko Adzic book cover.

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.


Continue reading