steveklabnik parent
Most of the things described in this document are also good for humans. The justification is different, but the result is the same.
Or as I like to say, if current AI cannot explain your documentation well, then it's very likely humans can't either, your documentation sucks.
If that was true people wouldn't title their articles "writing documentation for AI".
That’s just SEO for humans ;)
Would you care to make an actual argument about why these things aren’t good for humans too?
Because they encourage the newest way for .1% to rip off and monetize us. Write for humans not bots!
That isn't addressing my claim: what about "use semantic HTML," "provide text equivalents for visuals," or "keep layouts simple," for example, makes docs worse for humans?
It's a problem because it's coincidentally good now. Like saying "let's not do crime to please our supreme leader". No crime is better for people but what if tomorrow pleasing supreme leader will mean something else but we are already so accustomed to do things to please supreme leader, hey they used to be good for us before right?