2020-03-06: Programming by commenting the code My today's entry is about my work. As I've written before I'm a programmer. Some of my working days are more productive than the others, but in any case, I write a lot of code. Today there was an extraordinary day for me. I wrote a huge amount of lines, the vast majority of them was just comments. It was about twenty lines of real programming code and several hundred lines of text where I tried to explain what this code is intended to do. The task I was solving today was not very challenging by itself. Rather simple, I would say. But it was connected with asynchronous message incoming and possible loss of the arbitrary amount of them. Those obstacles made the simple task to be the very hard one. I had to comment literally any simple line of code to explain why it was necessary, what it meant, why this line written this way, and why someone can't do it simpler. The one moment make me be worried. I'm afraid in a month or two I can't understand what all those comments I've written are about. It happens often because at the moment you're writing them you are deep in the topic but when time passes you can't even remember what the problem was. I can only hope I was comprehensible enough to make the text having a sense for me and my colleagues afterwards.