That’s how I often use documentation - start documenting something, then ask myself “should the code be fixed to avoid the need to document this part? Yes, yes it should”.

A long provisioning instruction became much shorter as a result of automating it by reducing the need to document.