I saw this advice too, the problem with being very detailed is a question why not use a less ambiguous languages to do it?
Why not write the explanation in language like Python. Why should I write it in English when I can say the same thing in Python and it is actually easier to do for me.