В первый рабочий день нового 2014-го года хочется подвести итоги работы Отдела документации.
[spoiler]
Учебные курсы
Выстроенная в прошлые года линейка курсов пополнялась и развивалась. В основном развитие шло в сторону создания новых, тематических курсов, а также пополнения информацией текущих курсов. Что сделано:
Курс Пользователь КП стал сертифицируемым (По просьбам клиентов и партнёров).
Сколько создано уроков, глав - сказать невозможно, наш Модуль Обучение пока этого не позволяет. А вот отредактировано - 1658 страниц.
Сертификация
По нашим курсам пользователи за год (по состоянию на 24-е декабря) получили 18200 сертификатов.
Интересная деталь: Последний сертификат 2012-го года получен 31.12.2012 в 21:58:37. Первый сертификат 2013-го получен 01.01.2013 в 14:09:43. Последний сертификат 2013-го года получен 31.12.2013 в 22:23:00. Первый сертификат 2014-го получен 01.01.2013 в 14:58:25.
Не спится нашим пользователям!
Выдача сертификатов по курсам:
Контент-менеджер
6348
Администратор. Базовый
3655
Администратор. Модули
2925
Администратор. Бизнес
2662
Разработчик Bitrix Framework
1979
Курс для хостеров
682
Пользователь КП
103
Администратор КП
528
Документация
Ведётся (ещё не закончена) работа по простановке версий создания, изменения сущностей Bitrix Framework. И теперь, когда завершим работу, у каждого метода, сущности, события, будет стоять дата создания и отслежена история изменения параметров
В API доке в этом году появились большие дополнения:
JS-библиотека, долгожданный для разработчиков раздел.
Общая статистика работы:
API документация страниц создано
326
API документация страниц изменено
2546
Пользовательская документация страниц создано
69
Пользовательская документация страниц изменено
719
Rest_api документация страниц создано
237
CHM файлы
В этом году все оффлайн материалы курсов и документации публиковались в формате CHM. Файлы обновляеются ежемесячно и выходят в двух кодировках. Проблема с отставанием оффлайновой доки решена!
Видео
В этом году продолжалась работа по созданию видео для курсов. Записано и размещено в курсах примерно 2 часа 15 минут видео по разным темам. Видео писалось в основном для курса Битрикс24.
Эта работа, к сожалению, лишний раз доказала, что видео как вид документации - нерентабелен. Простое изменение интерфейса, даже без изменения логики работы делает видеозапись устаревшей. А темп работы наших разработчиков вам всем известен.
Оргработа
В плане организации работ в отделе в этом году большое внимание уделялось информированию пользователей. Впервые появились месячные отчёты по выполненной работе в текущем блоге. Но мы пошли и дальше. Создана страница Что нового?, где изменения в документации видны в режиме реального времени. Выпущена новая страница или отредактирована старая, тут же создаётся запись. Пользователи могут отслеживать эти сообщения по RSS.
Другое направление: облегчение поиска информации. С этой целью модифицирован Поиск на сайте. Стал возможен поиск только по курсам и документации.
Продолжаем поиск новых форм подачи информации пользователям. В этом году выпущена База знаний. База знаний - это каталог ссылок на те места нашем сайте, где есть решение какой-то проблемы. Первичное наполнение проводилось из учебных курсов силами нашего отдела. Правда пока этот инструмент пока не стал популярным. Он должен пополняться за счёт пользовательской активности, но она, к сожалению, не высока. Хотя данный инструмент просили сами пользователи.
Был небольшой сбой в системе сертификации, который доставил пару неприятных недель нашему отделу. Но все данные пользователей были восстановлены.
Выводы
Год был удачным. Удалось закрыть многие темы, о которых просили пользователи. Созданы дополнительные курсы, введена сертификация по последнему курсу из общей линейки курсов.
За курс по Виртуальной машине отдельное спасибо! Помнится когда такой развёрнутой инструкции не было, приходилось по крупицам собирать информацию как устанавливать и как чего настраивать в форуме. Будем надеяться, что новые фичи в Виртуальной машине будут оперативно отражаться и в данном курсе.
И да, в "Настройке memcached" немного непонятно почему приведены такие параметры. Фраза "Для этого необходимо:" означает, что именно для Битрикса необходимо такие параметры настроить или это пример настройки для нагруженного проекта? Ведь 1024 Мб из оперативы это довольно много...
Это пример настройки, но как правило практика показывает, что необходим приблизительно такой объем данных для эффективного кеширования.
Оценить объем памяти, необходимой для кеширования, можно по размеру вашего файлового кеша. Если у вас на проекте файловый кешь занимает 3 GB, то использование memcache c 256МБ памяти не будет эффективным за счет частого вытеснения.
Да, кстати, в новом ядре memcache настраивается совсем не в dbconn.php, а в файле "/bitrix/.settings.php" или "/bitrix/.settings_extra.php". Я например создал следующий .settings_extra.php:
Вчера, проходил тест на сертификацию "Разработчик Bitrix Framework. Модули" получил 14/15 (94,59%) но статус "тест не сдан", решил что ошибка в вопросах помеченных как "На этот вопрос нужно обязательно дать правильный ответ. Если ответ будет не правильным, то тест не будет пройден, даже если вы наберёте нужное число баллов" повторил тест логируя ответы, но в "Обязательно правильных" вопросах ошибок не нашёл. Сегодня просмотрев логи засомневался в одном из "простых" вопросов, пересдал тест с его учётом — получил 14/15 (94,59%) и статус уже "тест сдан" при тех же результатах, но вопрос то изменился из "необязательных". Решил что возможно вчера что-то работало не так и решил повторить тест со вчерашними ответами — опять получил 14/15 (94,59%) "тест сдан" - то есть с одними и теми же ответами получил два разных результата и с разными ответами получил один и тот же результат. Я не могу сдать тест с результатом больше 95% чтобы перейти к следующему тесту, куда можно обратиться за помощью?
Да, все верно. Для прохождения теста необходимо было набрать 95%. По случайности, из-за разного веса каждого вопроса получалось, что, даже ошибаясь в ответе на вопрос, тест засчитывался как "Не пройден", т.к необходимо было набрать 175.75 балла (у вас получалось 175 баллов ровно). Значение порога для сдачи теста с одной ошибкой был скорректировано. Теперь все должно быть хорошо.
Будем надеяться, что новые фичи в Виртуальной машине будут оперативно отражаться и в данном курсе.
Оценить объем памяти, необходимой для кеширования, можно по размеру вашего файлового кеша. Если у вас на проекте файловый кешь занимает 3 GB, то использование memcache c 256МБ памяти не будет эффективным за счет частого вытеснения.
Поправьте если ошибаюсь.
Default sender address - это не адрес SMTP-сервера, а имя почтового ящика.
Спасибо за замечание.
Значение порога для сдачи теста с одной ошибкой был скорректировано. Теперь все должно быть хорошо.
Спасибо за обращение.