> I read a lot of code too, which wasn’t always easy, but sometimes I was lucky enough to find myself treated to one of Robert’s epic block comments[0]. He wasn't exaggerating, that is an epic, beautiful, I would even say humbling block comment to read. It's completely outside of my regular knowledge domain but that is not at all required to appreciate it. [0] https://github.com/joyent/illumos-joyent/blob/dff0473c792…
software would be soooo much better if we lived in a world where a) engineering practice demanded devs document this well, and b) the majority of devs had the skill to write so well. market pressure however demands faster delivery times, and who cares about the tech debt.