Основная работа в этом месяце - это выпуск Rest API для Битрикс24. И она выпущена!
Кроме того близится к завершению документация по JS-библиотеке, в следующем месяце она будет доступна. Так же, надеемся, что в следующем месяце появятся тесты к курсу Пользователь КП. Мы сами не думали их вводить, но просьб от партнёров и клиентов по тестам этого курса было много, приходится их удовлетворять.
Видимой работы в этом месяце не много, так как отдел был занят подготовкой документации по Rest API для Маркетплейса Битрикс 24. Эта документация будет вывешена одновременно с самим Маркетплейсом (если молния куда-нить не ударит).
Месяц май традиционно короткий, но сделать удалось всё же не мало.
Прежде всего, запущена База знаний. Заполнение её происходит не так быстро, как нам хотелось бы, но тем не менее дело движется. Надеемся, что скоро она станет для вас действительно полезным инструментом.
Существует проблема для пользователей любой (не только нашей) сложной и объёмной системы: трудности поиска информации. Объём справочных и сценарных данных у развитых программных систем таков, что крайне легко потеряться в этом море букв, слов и картинок.
Так как наступают майские праздники и отчётность подводится заранее, то и сообщение о работе отдела за этот месяц вывесим тоже раньше. К сожалению нам не удалось по ряду причин выпустить Базу знаний в названные сроки. Она фактически готова, но остались некоторые недоделки в функционале. Но переезд сайта на новый дизайн отвлекает силы разработчиков. Тем не менее скоро, уже скоро станет доступной для наполнения и использования инструмент База знаний.
Документация пока не совсем полная. Кое-где нет примеров, кое-где требуются дополнения по содержанию. Но она уже есть и её можно использовать. Документация для API 6. Пока номер версии не имеет практического значения, так как приложения только вышли. Но в будущем разработчикам нужно будет учитывать этот номер при разработке для клиентов. Как и во всех наших продуктах обратная совместимость будет поддерживаться, но новый функционал на старых версиях будет недоступен.
Основной работой отдела в этом месяце было разработка положения о Базе знаний, разработка ТЗ для сайта и первичное наполнение Базы знаний. База знаний - это попытка собрать "в кучу" опыт решения практических задач. Учебные курсы - это теория, документация - это просто справка по полям интерфейса и АПИ. До сих пор не было какого-то единого места, где можно было бы получить информацию по решению конкретных задач, встающих перед контент-менеджерами, админами и разработчиками проектов.
Таким местом скоро станет База знаний. Это просто каталог ссылок на те места нашем сайте, где есть решение какой-то проблемы. Первичное наполнение будет из учебных курсов силами нашего отдела, в дальнейшем пользователи сами смогут пополнять Базу знаний.
Всё выше сказанное - это просто анонс. Будет детальное сообщение в блоге о Базе знаний, принципах её наполнения
Всем разработчикам известна и знакома трёхзвенная система документации для Фреймворков:
АПИ документация - описание классов, событий и прочего Reference guide - описание возможностей Training & Certification - сертификация для разработчиков.
Постепенно мы приближаемся к этой схеме, все изменения последних лет направлены на создание такой простой и понятной системы. АПИ документация как первичный инструмент была всегда. В последнее время описание возможностей (reference guide, сценарная часть) выносятся из неё в учебные курсы. В рамках этого переноса из АПИ документации удалён раздел Компоненты и некоторые страницы главы Инфоблоки.
Сами учебные курсы уже выстроены в линейку. Завершающим был Разработчик Bitrix Framework, к которому в этом месяце составлены и вывешены для прохождения тесты. Можете начинать сдачу тестов, все "шероховатости", которые обнаружите в тестах - писать куда, знаете.
Уведомление клиентов и разработчиков об изменениях в документации - потребность давно созревшая. Возможно, мы ошибались, затянув с её реализацией. Но как бы то ни было, теперь этот механизм создан и, надеемся, что уведомления будут ежемесячными.
Что включается в отчёт:
Создание новых страниц.
Удаление страниц с обязательным указанием причины.
Достаточно объемное редактирование страниц. Как правило – это какое-то редактирование под обновление системы.
Важные изменения на страницах, которые имеют большое значение в обычной работе. Например, примечания об особенностях функционала.
Не вносятся: мелкие изменения в документации в виде дополнений описаний новых полей и параметров, правка ошибок, ссылок, публикация комментариев пользователей и так далее.
Изменения в документации и курсах за январь месяц.
Мы перешли на файлы CHM вместо ПДФ для оффлайнового изучения курсов.
Причина банальная: высокая сложность для автоматического формирования файла PDF в нужном нам виде. Есть множество программ-генераторов, но мы не нашли ни одной, которая бы создавала файлы в приемлемом виде прямо из HTML. Приходилось вручную создавать и сопровождать файлы в формате DOC из которых уже и создавался PDF-файл.
С сегодняшнего дня все файлы для оффлайного изучения наших курсов будут доступны только в формате CHM. Разработчики сделали для Отдела документации автоматический конвертер, за что им большое спасибо. Теперь мы освобождены от большого объёма работ по отслеживаю актуальности файлов ПДФ и текущих курсов. А для пользователей теперь будут постоянно доступна свежая версия курсов. Файлы будут заменяться ежемесячно.
Отдел начал работу над тестами для курса Разработчик Bitrix Framework. Самое позднее в конце января он будет вывешен. Планируется что одновременно с этим Партнёрский отдел снимет с партнёрской программы устаревшие админские курсы. Хоть Партнёрский отдел и обещает что даст пару месяцев на прохождение новых курсов, но рекомендуем не затягивать.
Следом за этим планируем приступить к созданию Базы знаний, о необходимости которой долгое время говорили большевики обсуждало наше сообщество. Например, здесь. Удачи всем нам!
Сегодня вывешен курс Разработчик Bitrix Framework. Этим курсом завершается формирование линейки курсов по ролям. Но не завершается работа по совершенствованию и развитию процесса обучения в целом.
Вывешен Курс для контент-Менеджера для Bitrix .NET Forge CMS. Курс по аналогии с одноимённым курсом БУСа и сделан он нашим партнёром Кофедизайн. За что ему большое спасибо, и не только "спасибо", но и баллы начислены Партнёрским отделом. Нам, правда, пришлось переделать большую часть скриншотов, чтобы сделать курс "нейтральным". Курс будет включен и в дистрибутив.
Но новый курс - это, пожалуй, больше повод для сообщения. Главная новость всё же другая. На подходе к выпуску новый модуль Обучение. Мы очень долго просили у разработки этот функционал и вот он почти-почти готов. Завтра проходимся с разработчиком еще раз по тому что сотворено, потом отдаем на тестирование и модуль будет доступен для обновления.
Магазин обменивается данными с CRM по средством протокола CommerceML, поэтому очень важно, чтобы работа с протоколом в интернет-магазине была настроена правильно. Очень много возникает ошибок, связанных с настройками работы интернет-магазина с протоколом CommerceML и настройкой прав пользователя из под которого CRM обращается к интерент-магазину за новой порцией данных.
Пока не готова документация по интеграции CRM с магазином дам некоторые комментарии по настройке полей для правильного обмена данными.
Вопрос адекватности курсов - всегда субъективен. Но стремится к идеалу нужно, хоть он и не достижим.
К нашим тестам всегда были претензии и вряд ли когда кончатся. На днях одна девушка предложила мне в письме даже устроить голосование на форуме по поводу того верен ли ответ ответ на один из вопросов. Глупости глупостями, а совершенствовать работу надо.
На сайте идей опубликована идея создания видео для разработчиков. Наш отдел загружен работой так, что создавать такое видео мы не можем (пока). Но рассказать о том, как это сделать для тех, кто хочет создать такое видео (например по своим модулям) - без проблем.
Сегодня вывешен для изучения последний курс из линейки для администраторов: курс Администратор. Бизнес. Соответственно старый курс Администрирование Часть 3 снимается и исключается из сертификации.
Выпущен курс для хостинговых организаций, желающих получить компетенцию "Рекомендуемый хостинг". В курсе рассматриваются требования платформы Bitrix Framework к хостингу, вопросы установки, настройки продукта, а также вопросы инструментов и методов оптимизации серверов и баз данных для работы с системой.
Курс создан на основе Администратора. Базовый и адаптирован под потребности хостеров.
использована линейка тестов для облегчения прохождения;
уточнен и модифицирован список вопросов тестов.
(Одновременно с Курсом для Хостеров обновлялась информация и в соответствующих главах курсов Администратор. Базовый и Администратор КП.)
В связи с этим из курса Администратор. Базовый удален раздел по Монитору производительности и Конфигурировании веб-систем.
Партнерский отдел в ближайшее время изменит свои требования для хостеров. По этим вопросам обращайтесь к ним.
О текущем.
Близка к завершению работа над последним курсом из администраторских: Администратор. Бизнес.
В связи с принятием долгообсуждавшегося решения о переделке ядра приторможена работа над Разработчик Bitrix Framework до понятия того насколько измениться ядро. Так что в обещанные сроки (лето 2012) нам, увы не успеть.
Готовится АПИ по неописанным функциям, в частности по Задачам.
В преддверии праздника, увы с опозданием от планов, вышел курс Администратор. Модули.
Опоздание частично оправдано летними отпусками и тем, что в курс включался новый функционал 11-ой версии.
Немного о курсе
Курс "Администратор. Модули" позволяет освоить методы выполнения расширенных задач по администрированию модулей не относящихся к коммерческой деятельности.
Закончена работа и вывешен курс Администратор "1С-Битрикс: Корпоративный портал". Кроме обновления информации и описания новых фич произошли в курсе структурные и "мировоззренческие" изменения .
Поскольку БУС и КП все больше расходятся между собой и КП начинают заниматься IT-шинки никогда не имевшие никаких дел с "1С-Битрикс: Управление сайтом", мы включили в курс главы "Установка и настройка" и "Основы администрирования".
По просьбе ТП добавлен раздел "Настройка поиска документов" в главе "Установка и настройка".
Придерживаясь мнения о том, что пользоваться и управлять будут пользователи, выполняющие определенные роли, курс создан с рассмотрением двух администраторских ролей: Админ КП и Админ системы.
Тест сделан по аналогии с курсом "Администратор. Базовый": разбиты на небольшие тесты по 10-30 вопросов с заданным порядком прохождения и требованием 100% ответов.
Старый курс соответственно, снимается. Сертификаты по нему остаются на какое-то время действительны. (Обсуждается система ограничения времени действия сертификата каждого из курсов.) Всем новым партнерам для получения компетенции нужно проходить новый курс. Партнерский отдел поправит свои ссылки на сайте на новые в ближайшие дни. Исключат или нет из компетенции «Корпоративный портал» курсы "Администрирования БУС" - решит партнерский отдел.
Поскольку курс Администратор "1С-Битрикс: Корпоративный портал" входит в компетенцию «Корпоративный портал», архив курса не будет выложен в общий доступ.
Всегда будем рады замечаниям, вопросам, найденным ошибкам. ИХ можно озвучить здесь, можно в личку мне.
О текущих задачах.
Ведется повседневная работа над редактированием АПИ и пользовательской доки под изменения функционала и в связи с найденными (в том числе и вами) ошибками.
Ведется работа над курсом "Администрирование. Модули", который по выходу заменит курс "Администрирование. Часть 2". Примерный срок выхода - конец осени.
Приступили вплотную к работе над курсом "Разработчик Bitrix Framework". Сроки выхода пока не называем.
Закончена работа над курсом Пользователя КП. Работа длилась чуть дольше чем планировалось. Сделали курс.. и в очередной раз расстроились: опять разработчики на портале компании новые фичи внедрили, значит скоро будут эти фичи в дистрибутиве, значит опять переделывать.
Ну что ж поделать, такова наша работа.
Текущий курс войдет в дистрибутив "1С-Битрикс: Корпоративный портал" в следующем релизе, 10.5. Если кому он будет нужен раньше - обращайтесь, дам архив для включения курса в уже работающие порталы.
Курс сделан в общей тенденции: по ролям пользователей. Сотрудники в компаниях будут в разных группах пользователей, вот с точки зрения этих групп пользователей и описан функционал "1С-Битрикс: Корпоративный портал". Естественно, что описание дано согласно группам пользователей, имеющихся в дистрибутиве. Соглашусь, что дистрибутивные группы не исчерпывают всех потребностей владельцев портала, но мы не можем знать потребности каждой фирмы.
Ждем замечаний и предложений по этому курсу.
Теперь принимаемся за курс Администратора КП. Сроки его выхода затянуться, так как лето и работники у меня просятся в отпуска. Право законное, отказать не могу.
На несколько дней раньше обещанного срока выходит курс Быстрый старт разработчика. Это первое приближение к полноценной "Библии Битрикса" или "Философии Битрикса", кому как больше нравится.
Курс этот - учебный, не сертифицируемый. То есть тестов нем нет.
Скажу спасибо всем партнерам, кто оказал помощь в виде рецензирования курса. С вашей подачи многое уточнено и добавлено. Без вашей помощи создать действенный курс было бы сложнее. Жалко, что не у всех, кто обещал, хватило времени составить рецензию.
Как всегда мы открыты для критики и пожеланий. Готовы выслушать все замечания и, если они справедливы, исправить ошибки.
Текучка. Отдел работает над курсом пользователя КП. Курс будет не просто дополнен, но и существенно изменен и дополнен. Основное изменение: работа рассматривается по ролям групп пользователей, имеющихся по умолчанию в дистрибутиве КП.
По мере готовности главы по новому функционалу выносятся в текущий курс. Но в полной мере, надеемся, курс будет вывешен в конце мая.
Удачи всем нам!
UPD от 20.06.2013 Курс снят, так как готов полный курс разработчика.