What you have to realize is, that engineers hate writing data sheets and application notes. This is often left to interns during the summer vacation. I should know, I've worked in the semiconductor industry for over 40 years.
Large companies like TI have this under control, their documentation is generally of a very high quality, being maintained by professional technical editors.
But others, in this case Cirrus, apparently leave it as it is and rely on the product and application engineers to catch the issue when it comes up. This is fine for major customers who get a lot of attention, but bad for the little guy.