This post is a response to this forum posting by a Unity employee on why they are not going to have comments on documentation pages. That thread was locked, so I've posted my response here instead.
I wrote this because I think this stuff is really important. The documentation is not just "incomplete"; it is often out-of-date, misleading, and downright incorrect. The approach of throwing more people at the documentation team is completely missing the point: there is too much for you to document.
And, since our work forms part of the 'public face' of the company, we have to make sure that the content we produce - the grammar and language we use, the clarity and voice of the text, the screenshots, the layout and order of the pages, etc - all have to be consistent, and up to a certain quality which requires a process of writing, editing, proofing for english, proofing for technical correctness, an