Уведомление клиентов и разработчиков об изменениях в документации - потребность давно созревшая. Возможно, мы ошибались, затянув с её реализацией. Но как бы то ни было, теперь этот механизм создан и, надеемся, что уведомления будут ежемесячными.
Что включается в отчёт:
Создание новых страниц.
Удаление страниц с обязательным указанием причины.
Достаточно объемное редактирование страниц. Как правило – это какое-то редактирование под обновление системы.
Важные изменения на страницах, которые имеют большое значение в обычной работе. Например, примечания об особенностях функционала.
Не вносятся: мелкие изменения в документации в виде дополнений описаний новых полей и параметров, правка ошибок, ссылок, публикация комментариев пользователей и так далее.
Изменения в документации и курсах за январь месяц. [spoiler] Пользовательская документация Добавлено описание новой закладки История изменений (настройки модуля Интернет-магазин):
API документация Добавлена страница метода CEvent:: SendImmediate. Добавлен список событий (пока без описаний) модулей:
Удалены некоторые страницы АПИ документации (информация дублировалась, либо перенесена в курс Разработчик Bitrix Framework) (всего 14 страниц). На страницах документации сделаны ссылки на соответствующие страницы в курсе Разработчик Bitrix Framework. В ближайшее время из АПИ документации будут удаляться (точнее переноситься в курс Разработчик Bitrix Framework) сценарные описания.
Курс Контент-менеджер Создан урок Параметры компонента, описывающий принципы настройки параметров компонента.
На страницу Структура компонента добавлено описание нового способа (с 11-ой версии) формирования подсказок для тултипов.
Курс Пользователь КП Добавлено описание нового механизма публичных ссылок для файлов (Работа с документами в веб-браузере). Добавлено описание контекстного меню контакта в Веб-мессенджере (Веб-мессенджер v.12). На странице Настройки добавлена информация о возможности:
удаления выполненных звонков из календаря
удаления завершённых встреч из календаря
установки формата вывода ссылок схемы "callto"
На странице События, задачи, письма добавлена информация об обработке создания/редактирования/удаления календарных событий, в диалоги встречи/звонка добавлена поддержка выбора ответственного.
На странице Список задач добавлено примечание о возможности просмотра администратором всех задач пользователя.
Например, добавляется описание параметра, который существовал уже давно, не нового. Просто так получилось, что не был описан вовремя. Например здесь добавлен в ключи массива ключ PUBLISH_STATUS.
Роберт, уделите, пожалуйста, внимание методу CIBlockSection::GetList(). Он уже несколько лет имеет дополнительные и очень существенные параметры, по которым чуть ли не каждый день задаются вопросы на форуме.
P.S. Да, большое спасибо за сдвиги в работе над документацией!
просмотрите разделы по result_modifier и component_epilog в курсе разработчика. некоторые примеры с кодом неполные. и вообще мне кажется требуется обновление этих тем и лучшее объяснение, чем есть сейчас.
http://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&LESSON_ID=2975&LESSON_PATH=3913.4565.2975 двусмысленность в описании в примечании: "В файле component_epilog.php может быть любой код - только следует учитывать, что исполняться он будет «мимо кеша» на каждом хите. До версии главного модуля 10.0 в шаблон компонента передавалась копия массива arResult. В силу этого модификация этого массива в файле result_modifier.php не давала никаких результатов. Чтобы стало возможным изменение результатов вывода закешированных данных нужно разместить в файле result_modifier.php следующий код:"
- из этого описания неясно нужно использовать данный код для версии главного модуля > 10.0 или нет.
P.S. Да, большое спасибо за сдвиги в работе над документацией!
некоторые примеры с кодом неполные. и вообще мне кажется требуется обновление этих тем и лучшее объяснение, чем есть сейчас.
двусмысленность в описании в примечании:
"В файле component_epilog.php может быть любой код - только следует учитывать, что исполняться он будет «мимо кеша» на каждом хите. До версии главного модуля 10.0 в шаблон компонента передавалась копия массива arResult. В силу этого модификация этого массива в файле result_modifier.php не давала никаких результатов. Чтобы стало возможным изменение результатов вывода закешированных данных нужно разместить в файле result_modifier.php следующий код:"
- из этого описания неясно нужно использовать данный код для версии главного модуля > 10.0 или нет.
в документации по API тоже самое:
- в позаголовке "Изменения в шаблоне" неполный кусок кода после "А также создайте result_modifier.php, где разместите такой код:"
- п.2 "smile" вместо скобки
- п.3 неполный кусок кода