We often talk about avoiding unecessary comments that needlessly paraphrase
what the code does. In this article, I gathered some thoughts about why
writing comments is as important as writing the code itself.
GO111MODULE is all over the place. It appears in README install
instructions, in Dockerfiles, in makefiles. On top of that, the behavior of
GO111MODULE has changed from Go 1.11 to 1.12, changed again with 1.13 and
will changed a last time in 1.14.
Although progress is being made, Kubernetes controllers and operators
still require prior knowledge about Kubernetes internals. Information on
how to set the status is scattered across comments, issues, PRs and the
Kubernetes code itself. Conditions may be a good solution for your
controller, but for what?