Состояние документации к Битриксу

Ну состояние не такое уж плачевное. Многие считают доку вполне примлемой, а мне встречались и хвалебные отзывы. Правда, мы критично относимся к такой реакции и понимаем что недостатки у нас есть и над ними надо работать.

Спорный момент, но оставим религиозные войны.  

Ну вы же как-то определили?
ДА, такое есть. С выпуском седьмой версии мы переходим на формирование документации в виде инфоблоков. В этом случае все изменения в продукте будут оперативно отображаться на сайте. Как в виде он-лайн справки, так и в виде chm файла.

Если бы автор документации был один.  
Документация такого уровня пробукта как Битрикс - это совместный плод многих людей. Как работающих так и работавших. Даже если и найдется гений, представляете сколько времени ему надо на переделку всей доки? А пока он делает это выходят апдейты и новые версии. Опять переделывать приходится.


Про это вам уже ответили.

ДА, дока не совершенна, это так и это во-первых.
К совершенству мы стремимся, это во-вторых.

В третьих, мне кажется, что многие путают файл помощи с Руководством по эксплуатации.

Понятно, что большинству требуется именно Руководство. НАд этим мы сейчас работаем. Часть руководств по разным видам задач выложена уже на сайте. Часть руководств появиться в ближайшее время.

Сейчас готовятся пошаговые руководства для инсталляции продукта, интеграции дизайна в него и наполнение контентом. Руководство именно для начинающих. Без всяких программерских изысков, только на базе версии Стандарт.