This depends on so many variable that I don't believe there's one perfect commmit. E.g. it depends in the lifecycle stage of the project. Is it just you figurin

This depends on so many variable that I don't believe there's one perfect commmit. E.g. it depends in the lifecycle stage of the project. Is it just you figuring something out, or are hundreds of thousands of people depending on your work with their livelihoods? The first probably deserves the kinds of restraint that Op wants to see. Whereas you would terribly stifle you creative flow if you were to write docs for your explorative work in the unknown.