Документация, курсы и все остальное...

Сегодня вывешен для изучения последний курс из линейки для администраторов: курс Администратор. Бизнес. Соответственно старый курс Администрирование Часть 3 снимается и исключается из сертификации.

Читать подробнее...

В преддверии праздника, увы с опозданием от планов, вышел курс Администратор. Модули.

Опоздание частично оправдано летними отпусками и тем, что в курс включался новый функционал 11-ой версии.

Немного о курсе

Курс "Администратор. Модули" позволяет освоить методы выполнения расширенных задач по администрированию модулей не относящихся к коммерческой деятельности.

Читать подробнее...

Очередные новости от отдела Документации

Закончена работа над курсом Пользователя КП. Работа длилась чуть дольше чем планировалось. Сделали курс.. и в очередной раз расстроились: опять разработчики на портале компании новые фичи внедрили, значит скоро будут эти фичи в дистрибутиве, значит опять переделывать.

Ну что ж поделать, такова наша работа.

Текущий курс войдет в дистрибутив "1С-Битрикс: Корпоративный портал" в следующем релизе, 10.5. Если кому он будет нужен раньше - обращайтесь, дам архив для включения курса в уже работающие порталы.

Курс сделан в общей тенденции: по ролям пользователей. Сотрудники в компаниях будут в разных группах пользователей, вот с точки зрения этих групп пользователей и описан функционал "1С-Битрикс: Корпоративный портал".
Естественно, что описание дано согласно группам пользователей, имеющихся в дистрибутиве. Соглашусь, что дистрибутивные группы не исчерпывают всех потребностей владельцев портала, но мы не можем знать потребности каждой фирмы.

Ждем замечаний и предложений по этому курсу.

Теперь принимаемся за курс Администратора КП. Сроки его выхода затянуться, так как лето и работники у меня просятся в отпуска. Право законное, отказать не могу.

Побывал в командировке в Москве на Саммите разработчиков электронных курсов. Аудитория была достаточно большая: в зале около 200 участников и по уверениям организаторов еще столько же в он-лайн.
Целей поездки было две:

1. посмотреть тенденции электронного обучения, понять что у нас "так" с этим, что "не так" и "камо грядеши" eLearning сам по себе.
   
2. попытаться понять насколько наш Битрикс как софт может отвечать потребностям ниши электронного обучения.
   

Первое.  Вывод, идем в ногу! В качестве проверки нашего уровня подали наш курс Контент-менеджер на проходивший в рамках Саммита конкурс электронных курсов. Результат - пятое место из 30. Вроде результат - хороший.

Правда, когда общались "в кулуарах" один из экспертов (г-н Калинников) сказал, что у него было 2 часа на все курсы для оценки. Как можно 30 курсов просмотреть и оценить за 2 часа, трудно представить. Но личная оценка курса прозвучала такая: "добротно сделано".  Эксперту даже не пришлось напоминать про какой курс идет речь, он его вспомнил по названию.

Обещали выслать полную выписку оценок от экспертов, посмотрим поближе, изучим.

Когда просматривал сам чужие курсы понял, что надо менять шаблон для курсов на более современный. Поставили в задачи.

Есть некоторые замечания по курсам по мелочам, которые будем учитывать в процессе работы. И реализовывать надо дополнительный функционал к модулю Обучение, но об этом ниже.

Второе. В целом наш Битрикс соответствует текущему уровню софта для создания учебных курсов за исключением одного: проблем экспорта,импорта в Scorm. В ближайшее время ставлю себе задачу оттестировать "на себе" этот функционал и довести с разработчиками "до ума".

При общении "в кулуарах" выяснилось, что наш "1С-Битрикс: Корпоративный портал" практически полностью устраивает ВУЗы. И внедрению его мешают не какие-то недостающие фичи , а внутренние проблемы ВУЗов, какие вот только - не распространялись.

Очень к месту пришелся модуль "Социальные сервисы". О соцсетях много говорилось на Саммите и я понял, что модуль вышел вовремя.

О необходимости доработки модуля Обучение и продвижении

Как мне кажется, удалось понять основные фичи, которые в ближайшее время надо доделать в модуле Обучение, что бы сделать его еще более привлекательным для этого сектора рынка. Потенциального и большого.


Общий список того что можно и нужно доделать в Обучении я составлю, пока общие направления:

1. инструменты обратной связи
   
2. инструменты оценки курсов, глав, уроков голосованием пользователей
   
3. Прикрутить возможность отправлять цитаты из текста, куда-то в соц-сеть.
   
4. Scorm оттестировать
   
5. Теги для уроков и облако тегов как навигация.
   

Считаю, что нужно подумать о представлении нашего "1С-Битрикс: Корпоративный портал" на аналогичных профилированных мероприятиях. Не знаю про другие отрасли, но в eLearning мы точно можем эффективно подать себя и продать себя. 
 
Школа разработчика 1С-Битрикс
Попутно побывал на Школе разработчиков Битрикса в Москве, на Селезневской. Проводил Школу Валерий Кондаков.
В целом пользователи были довольны и мне тоже вроде показалось не плохо. Потребность в таких мероприятиях есть.

Еще из новостей

Обнаружена первая попытка подделки наших сертификатов. Человек выставил на Фри-лансе.ру 12 наших сертификатов, которые он якобы имел. Убедили его в том, что он заблуждается, и с помощью администрации проекта Фри-ланс.ру упросили снять сертификаты со своего аккаунта.

Еще из новостей

Процентов на 70 готов курс Быстрый старт Разработчика. Курс учебный, не сертификационный. Первое приближение к полной "Библии Битрикса"... Если есть желающие просмотреть, изучить и дать рецензию: что "так" и что "не так" - милости просим. Причем приглашаем не только ГУРУ Битрикса, но и новичков.

Как уже писалось ранее, проводится изменение системы сертификации специалистов по платформе Bitrix Framework. Сегодня вывешен первый курс Контент-менеджер.

Отличие создаваемой линейки курсов в том, что они теперь строятся по функциональному принципу. То есть курс не рассказывает о каком-то модуле, редакции "вообще", а рассказывает о системе "1С-Битрикс: Управление сайтом" с точки зрения человека, выполняющего определенную работу с системой.

Читать подробнее...

Рост объемов работ, приходящихся на отдел документации, и стремление Гендиректора Рыжикова к интенсивному, а не экстенсивному развитию, (во я загнул!) поставили вопрос об изменениях в работе раздела. Тема эта давно крутилась в мозгах, обсасывалась с коллективом. НО пока не было согласия разработчиков на доработку модуля Обучение, все оставалось только в виде радужных надежд.

Теперь такое согласие на включение работ по модулю Обучение есть. Новый модуль будет к осени. Это позволит нам несколько изменить работу отдела. В чем будут изменения?

Читать подробнее...

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

Подумалось, а почему бы и не рассказать о том, как мы сработали в этом году?

Итак.

1. На "содержании" у нас четыре продукта (БУС, БУС-NET, КП и SAAS) и раздел Документация у нас на сайте.

2. Эти продукты обслуживают 6 видов документации: Онлайн дока (она же - CHM), комментарии к ней, руководства, учебные курсы, видеоролики, файлы help в дистрибутивах, книги.

Читать подробнее...

Создана страница со всеми видеоматериалами, которые имеются на данный момент в учебном (не PR) плане на нашем сайте. Это страница Учебные видеоролики.

На этой странице собраны и систематизированы по продуктам имеющиеся видеоматериалы.

Кроме этого, решили оставить и старые Flash-ролики. Они устарели интерфейсно, но по принципам работы - актуальны.

Последняя закладка на странице - учебные видеоролики предоставленные компанией TeachVideo. Компания специализируется на учебном видео и представленные уроки просто подарила нам. За что им отдельное спасибо.

Ролики выложены не все что у них есть. Из их большого курса (49 уроков) отобраны 21, посвященные визуальному редактору. Тема визредактора в них раскрыта очень хорошо. Эти ролики можно рекомендовать клиентам для контент-менеджеров. Разработчикам ролики вряд ли что-то дадут.

Все новые видеоматериалы учебного характера теперь будут выкладываться не в блоге, а на этой странице.

"На выходные с чистой совестью!"

Видео по модулю Экстранет сделали на день позже чем планировалось:
Camtasia Studio в эту неделю много выпендривалась, но мы ее победили!. Поэтому можем сказать:
"На выходные с чистой совестью!"

Удалось частично решить проблемы со звуком. Ролик получился по времени довольно большой 11 минут 13 сек. Размер в пределах статистики: чуть меньше 5 мег на минуту видео. В сумме - 53,5 "метра".

Итак, само видео:




Скачать (53,5 М)

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

Прежде всего, это сценарии. То что просто пишется в тексте оказалось не просто показать. (Татьяна Старкова, наш ведущий специалист по документации, наверное теперь лучше понимает кинорежиссеров, которым из сценария фильма нужно сделать высокопрофессиональный видеоряд, достойный Оскара. )

Трудно оказалось и снять исходный материал. Воспользовавшись отсутствием Гендиректора, окупировали его кабинет, что бы никто не мешал. И все равно из-за шумов (хлопки дверью, чьи-то разговоры за стенкой) приходилось переписывать отснятый материал. (Татьяна осваивает работу оператора.)

Другой трудностью было - "красивое" монтирование отснятого материала. Все предусмотреть и правильно показать, выделить. Спасибо создателям Camtasia Studio за отличные возможности программы. (Татьяна осваивает работу монтажера.)

Как бы там ни было, но курсы дополнены видеороликами. За 7 рабочих дней записано несколько часов видео, которые ужались в примерно 40 минут чистого времени роликов. Все ролики размещены на соответствующих страницах курсов. Вот некоторые ссылки:

• Создание календаря событий;
  
• Анализ эффективности рекламной кампании;
  
• Создание новой страницы;
  
• Редактирование меню.
  

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

Единственное чего не знаю, насколько данный документ востребован будет. Честно. Ни на форумах, ни в личном общении с разработчиками эта тема ни разу не всплывала. Возможно, что Microsoft'у виднее.
И поскольку "Пример миграции базы сайта с MySQL на SQL Server Express" фактически и сделал Microsoft (с нашей стороны только приведение его к стандартному оформлению), то особо не расстроюсь, если статистика его загрузок будет не высокой.

Как отдельный положительный момент этого документа отмечу - описание установки "1С-Битрикс: Управление сайтом" на базу SQL Server Express. Раньше такого описания не было, мы ограничивались в документации по установке лишь базой MySQL, как входящей в "Битрикс Веб-окружение".

Этот момент отметила и наша поддержка сразу же. Теперь ей есть куда посылать пользователей при вопросах "Как поставить продукт на MS SQL?".

По просьбе того же саппорта в "Руководство по установке" добавлено пара примечаний, упоминание о моментах, которые нам казались очевидными. Это замечание про то, что архив с дистрибутивом надо распаковывать именно в корневую папку, а не куда-то в другое место. Нам казалось это понятным и естественным, а оказывается не все так просто. Страшно подумать, но кто-то, оказывается, может думать не так как мы и устанавливать продукт не в корневой папке!!!

Впрочем, это не первое подобное изменение. Помнится и в Руководстве по установке "1С-Битрикс: Корпоративный портал" пришлось делать замечание о том, что он устанавливается только на сервер, а на клиентские машины ничего не надо ставить.

В связи с этим просьба к сообществу. Есть моменты в документации, которые очевидны для нас, но вызывают вопросы ваших клиентов (или ваши). Пишите, сообщайте. Все подправим.

Впрочем, спасибо сообществу в целом за работу в комментариях к документации. Благодаря вашим замечаниям исправлено довольно много, несколько десятков, ошибок и внесено почти сотня дополнений, примеров. Отдельное СПАСИБО самым активным. "Вспомним их поименно..":
Роман Забродин;
ipn,
0987,
logic,
Иван Неслуховский,
EvGenius,
Алена Бабой.

О всех исправлениях мы сообщаем тому, кто заметил ошибку. Если вы написали замечание но вам не пришло такое сообщение, то это означает, что нам, документалистам, не с кем проконсультироваться. Разработчики, к сожалению, иногда ходят в отпуск и болеют.

И, конечно, без ответа остаются сообщения в комментариях к документации типа: "А как сделать то-то..." Напоминаем, что комментарии - это не форум.

Появление комментариев в документации для разработчиков на данный момент оправдывает себя. Комментарии к документации хоть и не всегда объемные, но появляются почти каждый день. Правда, к сожалению поля комментариев воспринимаются больше как окно для жалоб, чем как средство поделиться знаниями. Повторяю еще раз: пропускаться будет только то, что дает какую-то практическую помощь вашим товарищам.

Впрочем, рассматриваются все сообщения и даже если они не прошли, но в них есть полезное зерно, то все рано будут рассмотрены. Так по некоторым сообщениям произведены исправления ошибок, добавлены возможности в компоненты.

Обнаружилась еще одно полезное свойство, совсем даже не предполагавшееся нами. Меня давно мучала мысль как реализовать сбор полезных решений из форумов, которые просто теряются в общей массе сообщений. Включать в документацию - нельзя, не тот формат. Писать отдельные документы-руководства - тоже как-то не получается. ФАК - тоже не тот формат: вопросы бывают мелкие и не часто востребованные. Но нужные. Будем включать их в комментарии.

Создание комментариев вызвало объективную потребность у вас, наших партнеров и разработчиков, в получении самой свежей информации по создаваемым сообщениям. Просьбы о RSS появились практически сразу после первых комментариев.

Сообщаю, реализовано. Подписаться на RSS на комментарии можно здесь.

При реализации RSS для комментариев возникла идея и создать RSS для самой доки. Как для разработчиков, так и для пользовательской. Суть проблемы аналогичная: документация пополняется, вам желательно иметь информацию о появившихся страницах. Постараемся в ближайшее время сделать и это. Если вам это нужно, конечно.

Ну вот, открыто новое направление работы для отдела документации - это ASP.NET.

Пока есть всего три документа: CHM по API для разработчиков и пара пробных документов по установке.

CHM по API - первый вариант, начальный. Будет пополняться .

А вот документация по установке будет изменяться: переделываться под наши стандарты по документации и дополняться информацией по установке на IIS.
Существующие документы делал САМ руководитель направления ASP.NET - Юра Тушинский, пока наш отдел был занят докой по Корпоративному порталу.

Удачи вам в вашей работе...

Вышла книга «1С-Битрикс: Постройте профессиональный сайт сами!» Как автор хочу высказать благодарность всем, кто помогал автору в создании этой книги:
Прежде всего самому главному главному консультанту Дмитрию Вальянову, а так же:
Ирине Юртаевой,
Антону Ежкову,
Максиму Смирнову,
Диме Власову.
А также всем остальным, кто вольно (или не вольно ) помогал в написании книги.

Мне, как автору очень бы хотелось получить обратную связь от читателей: что в книге "не так".. Что-то освещено не достаточно, что-то избыточно..
Буду очень признателен за такие отзывы.

Параллельно с текущей работой над документацией мы начали и закончили "визуализацию" первой ласточки - курса "Элементы управления. (BX-ADM001)".
Практически каждый урок сопровождается видеороликом. Убирать старые флеш-ролики мы не стали, вдруг кому-то понадобится.
Размеры роликов довольно большие. Но таковы веяния времени - высокоскоростной доступ все более доступен. Поэтому мы старались не экономить на качестве.

Один из роликов (4 минуты, 16,3 Мб.):


С удовольствием примем любые замечания по содержанию роликов и их графическому оформлению.

Следующая задача - "визуализация" курса "Визуальный HTML-редактор".

Но нас на данный момент интересует другое. Визуализировать курсы с конкретным содержанием - просто. Что трудного в составлении сценария, описывающего работу HTML-редактора? Все видно и наглядно. А вот попробовать описать процесс более абстрактный - это еще нам надо научиться.. Попробуем на примере курса "Многосайтовость" и надеемся на успех.