Good articles Rene. I agree on both: current and self-documenting. As you know, I started a movement to document code in January: CodeDoc Movement, and wrote an article about it: https://mcvendrell.medium.com/welcome-to-the-codedoc-movement-49c21a0af5c4

Basically, I covered all the points you explain here with some examples too.