ICL Services
Новости
15 декабря 2021
Новости

Готово!

Скоро материал придет на указанную электронную почту. Также подписывайте на нас в Facebook

Ok

Как использовать DDD и BDD при внедрении систем

Всем привет! Вот уже несколько лет я занимаюсь построением процессов и внедрением ITSM-систем. В проектах внедрения систем у заказчика стремлюсь использовать принципы BDD (Behavior Driven Development) и DDD (Documentation Driven Development) и немножко KCS по причине собственной лени (двигатель прогресса!) и сильного нежелания заново возвращаться к «пройденному».

Не секрет, что многие очень не любят писать документацию, а особенно пользовательские инструкции – и я исключением не являюсь. Раньше, когда я работала в эксплуатационном подразделении внутреннего ИТ, меня надо было несколько раз спросить одно и тоже, чтобы я села и написала инструкцию: не спросили – не пишешь.

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

  1. Я же уже 100 раз всем все объясняла – так о чем писать?

  2. Эти настройки видела неделю назад, и по факту возвращаюсь к ним же, как надоело!

  3. Так, а тут что мы имели в виду? Опять перечитывать документы и комментарии…

В общем, все эмоции как правило сводятся к мысли «я опять делаю одно и то же». Тогда на глаза попалась методология KCS, которая помогла сделать первые шаги в направлении «сначала документируй, а потом делай».

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

Но при чем тут вообще перечисленные в заголовке практики? Разберем подробнее.


Пример


В рамках небольшого проекта по внедрению Jira пишем:

  • - техническое задание;
  • - документацию настроек системы (логика переходов в процессах, настройки безопасности, автоматизация и прочее);
  • - описание API для разработчиков смежных систем (опционально);
    -инструкцию пользователя;
    - инструкцию администратора.  


А чтобы узнать о каждом пункте подробнее и выводах автора, читайте полную статью на Хабре.
Поделиться:

Новости по теме

    Свяжитесь с нами

    Контакты Пресс-службы
    Телефон 8 (800) 333-98-70

    pr@icl-services.com

    Будьте в курсе новостей

    Подпишитесь на рассылку и будьте в курсе наших последних новостей

    Подписаться на рассылку
    Спасибо, что подписались на рассылку новостей! Адрес подписки успешно добавлен! Ok
    На сайтах icl-services.com используются cookie-файлы. Оставаясь на сайте, вы даете свое согласие на использование нами cookie-файлов. Если, прочитав данное сообщение, вы не согласны, просим вас покинуть сайт.

    Задать вопрос эксперту

    Ф.И.О*
    E-mail*
    Наименование организации*
    Должность*
    Телефон*
    Вопрос*

    Я даю согласие на обработку своих персональных данных в соответствии со статьей 9 Федерального закона от 27 июля 2006 г. N 152-ФЗ«О персональных данных»

    Заказать звонок

    Ф.И.О*
    Контактный телефон*
    E-mail
    Компания*

    Я даю согласие на обработку своих персональных данных в соответствии со статьей 9 Федерального закона от 27 июля 2006 г. N 152-ФЗ«О персональных данных»

    Наверх