Обсуждать эту тему можно бесконечно долго. Всегда найдутся люди, которым будет что-то непонятно. Не проще ли просто ответить человеку на его вопрос? И все. А документацию можно исправлять, причем сразу, как обнаружена ошибка или неточность и тут же обновлять на сайте. Это же не долго. Тогда таких тем просто не будет.