Полнота документации — новые классы не документированы. Басыров Роберт а не подскажете, какое сейчас покрытие документацией классов в процентном соотношении?
Скорость её обновления — разработчики пишут код, а не документацию к нему. Потом пытаются нагнать.
Отсутствие документации в формате phpDoc — тема для отдельного холивара, но некоторые просят )
Безумная пятничная идея 1. Берём модуль LiveAPI от Sharomov Denis — http://marketplace.1c-bitrix.ru/solut...x.liveapi/ и немного «подкрутив» его сохраняем результаты работы в ИБ. Т.е. нам надо что бы элементом ИБ был метод класса или обработчик события или константа.
Таким образом мы получаем кучу записей вида CDataXML::Load($file) которые можно разобрать программно до состояния вида:
Наименование метода и его человеческое название
Список аргументов и их типы
Тип возвращаемого результата
Т.е. мы получим элементы ИБ у которых будет много свойств и большая часть из них не будет заполнена.
2. Пишем парсер, который сможет распознавать структуру http://dev.1c-bitrix.ru/api_help/ и на запрос вида CIBlockElement::GetList будет делаться запрос по адресу модуль/classes/название класса/название метода.php и оттуда будет выдираться структура и документация по названию метода, свойствам, типу возвращаемых результатов.
3. Погоняв связку из модифицированного LiveAPI и парсера мы получим у себя частично заполненный массив ИБ.
Тут мы уже сможем:
оценить полноту документации по последней версии битрикса
видеть, какие элементы не заполнены или отсутствуют вообще в документации.
И самое главное — сможем нарисовать УДОБНЫЙ интерфейс по заполнению свойств у элементов ИБ. Т.е. у нас будет коллективная редактилка документации кем угодно из нашего сообщества. Естественно используя все прелести хранения данных в ИБ.
Соответственно можно просить сообщество дописывать документацию и отдавать эти дельты Роберту для вычитки и проверки.
С выходом новых версий Bitrix всё сведётся к переиндексации исходного кода модулей и получения нового списка правок.
Внезапный бонус от структурированного хранения документации — можно основательно подкрутить скрипт LiveAPI и заставить его модифицировать файлы ядра обогащая их комментариями в формате PHPDoc если кому то так уж это надо для красивых подсказок. Правда тут уже никто не застрахован от ошибок и гнева системы контроля целостности ядра Кажется меня сейчас забанят.
Риски
Некоторые плачут о том что документация плохая и её мало, но мало кто будет её писать.
Документация будет написана, но в ней будет масса ошибок.
что забыл?
Как можно взаимодействовать с сообществом и таки улучшить документацию.
Попросить принять посильное участие.
Сделать конкурс с раздачей призов.
Давать партнерские баллы.
Может придумаем ещё пяток вариантов как сделать нашу жизнь с Bitrix приятнее?
Да что говорить, если некоторый функционал принципиально не хотят публиковать уже лет 5, комментарии пользователей конечно хорошо, но порой там публикуют откровенный не проверенный бред. http://idea.1c-bitrix.ru/dokumentirov...-svoystva/ - как прокомментируют не желание публиковать документацию к тому что все пользуют?
Группы на сайте создаются не только сотрудниками «1С-Битрикс», но и партнерами компании. Поэтому мнения участников групп могут не совпадать с позицией компании «1С-Битрикс».