I really like your point about third party documentation. I've written the "this is dumb" line before but that's usually on a forum not a doc.