Для разработчиков, привыкших к практикам agile, всегда действует один из принципов этой методологии: «Работающий продукт важнее исчерпывающей документации». В переводе на русский с философского это значит: самое главное это рабочий продукт, который можно отдать заказчику и пользователям. При этом документация (отчетность, графики, требования и проч.) глубоко вторична.
Тогда зачем же обязательно выпускать релиз ноутс? Ведь в случае пользовательской справки, например, можно и повременить. Часто возникают ситуации, когда несколько топиков (страниц) пользовательской справки пишутся уже после релиза продукта, как бы «вдогонку». Это особенно удобно делать в программах для управления документацией (Content Management Systems – CMS), ориентированных на постраничный формат – формат топиков).
Однако в случае релиз ноутс этот вариант не подойдет. Этот документ нельзя откладывать на потом, поскольку он является одним из ключевых этапов разработки и обновления программного обеспечения (ПО). Цель релиз ноутс – информирование пользователей об изменениях в новой версии продукта. Ключевое слово здесь – «новая». Релиз ноутс помогают пользователям адаптироваться именно к нововведениям, а также способствуют прозрачности отношений между разработчиками и их аудиторией.
Рассмотрим содержание релиз ноутс, их функции, а также алгоритм их составления и структурирования, чтобы обеспечить их максимальную пользу для всех заинтересованных сторон.
Что такое релиз ноутс?
Релиз ноутс (от англ. release notes) — это документ, который сопровождает обновления ПО. Он помогает пользователям понять, какие изменения были внесены и как они могут повлиять на использование системы. Данный документ обычно содержит описание новых функций и возможностей, сведения о текущих проблемах, а также инструкции по установке или обновлению до новой версии. Релиз ноутс является важным инструментом коммуникации между разработчиками и пользователями, способствующим продвижению и улучшению цифрового продукта.
Зачем обновлять документацию?
Обновление документации – это важный этап в разработке новой версии ПО. Оно позволяет обеспечить актуальность и точность информации.
- Обновлённая документация содержит подробное описание новых функций и возможностей продукта. Это помогает пользователям понять, как использовать новые инструменты и функции. Если релиз ноутсы написаны грамотно и качественно, ознакомление с таким документом повышает продуктивность работы читателей и их удовлетворённость продуктом.
- Во-вторых, релиз ноутс содержат информацию об исправленных ошибках, что позволяет пользователям узнать о решении ранее выявленных проблем и избегать возможных трудностей при использовании программного обеспечения.
- Кроме того, обновлённая документация информирует целевую аудиторию об улучшениях и изменениях в продукте, таких как повышение производительности, улучшение безопасности или изменение интерфейса. Это помогает пользователям подготовиться к изменениям и максимально эффективно использовать новую версию программного обеспечения.
- Наконец, своевременное обновление документации демонстрирует серьёзное отношение компании к поддержке и развитию своего продукта, укрепляя доверие пользователей. Это также способствует прозрачности, так как пользователи получают полную и точную информацию о продукте и его развитии.
Таким образом, обновление релиз ноутс – это важная составляющая процесса выпуска и поддержки программного обеспечения, которая обеспечивает пользователям информацию, необходимую для эффективного использования ПО.
Содержание релиз ноутс
Состав релиз ноутс зависит от продукта. Например, документы релиза для программного обеспечения обычно сосредоточены на исправлениях ошибок, новых функциях и известных проблемах, в то время как документы релиза для аппаратного обеспечения могут содержать информацию о новых технологиях, изменениях в дизайне и возможных несовместимостях.
Релиз ноутс для ПО, как правило, включают следующие разделы:
- Введение. Здесь представлена общая информация об обновлении, включая его цель и значимость, краткое описание изменений, а также версию обновления и дату выпуска.
- Совместимость и требования. Этот раздел помогает пользователям убедиться, что их компьютер соответствует необходимым требованиям для установки и правильной работы обновления.
- Инструкции по установке: пошаговое руководство по установке новой версии.
- Новые функции. Подробное описание всех изменений, внесённых в программу, позволяет пользователям быстро и эффективно ознакомиться с нововведениями.
- Исправленные ошибки. Здесь представлен перечень устранённых проблем и багов, существовавших в предыдущих версиях.
- Известные проблемы. Информация о текущих проблемах, которые ещё не были решены, подготавливает пользователей к возможным затруднениям.
- Обратная связь и поддержка. Контактная информация для поддержки и обратной связи позволит пользователям оставлять комментарии и задавать вопросы.
- Заключение. Здесь может быть любая дополнительная информация или замечания.
Эти пункты обеспечивают пользователей всесторонней информацией о новой версии ПО, способствуя их удовлетворенности продуктом.
Значение релиз ноутс
Сложно представить, но многие до сих пор относятся к релиз ноутс несерьезно, считая этот документ необязательным. Возможно, для некоторых продуктов это и так, но существуют целые отрасли, в которых выпуск продукта (товара) невозможен без выпуска релиза. То есть наличие релиз ноутс – это требование регулирующих органов, связанное с обеспечением безопасности.
Данное требование актуально, например, для медицинского оборудования. Релизы необходимы для информирования пользователей о новых функциях, исправленных ошибках и изменениях в безопасности. Более того, в США и Европе, производители медицинского оборудования обязаны сообщать в релизах о несчастных случаях, связанных с их продуктами. Такое же требование (включая сообщения о несчастных случаях) действует в авиационной, космической и автомобильной отраслях.
В целом, выпуск релизов является важным инструментом для соблюдения стандартов безопасности и информирования пользователей о новых функциях и исправлениях в различных отраслях.
Релиз ноутс облегчают взаимодействие с продуктом, выполняя следующие функции:
- Информирование. Благодаря релиз ноутсам пользователи узнают о наличии обновлений.
- Описание нововведений. Документ содержит детальное описание всех новых функций позволяет быстро ознакомиться с их особенностями и преимуществами и приступить непосредственно к работе с ИТ-продуктом.
- Перечень исправлений. Необходимая информация о внесённых изменениях помогает принять решение об обновлении. Однако вопрос о перечне исправленных багов является неоднозначным. Часто, когда пользователи видят длинный список внесенных исправлений, они начинают сомневаться в качестве продукта, что ведет к потере лояльности. Есть также противоположное мнение. Оно состоит в том, что все пользователи понимают, что невозможно выпустить продукт без багов и что, наоборот, подробный перечень исправлений говорит о приоритетности вопроса качества для компании. Последнее косвенно укрепляет лояльность существующих клиентов и привлекает новых.
- Улучшение пользовательского опыта. Релиз ноутс помогают эффективнее использовать ПО.
- Снижение числа запросов в поддержку. Подробная документация может значительно уменьшить количество обращений и «разгрузить» службу поддержки, которая, как правило, вынуждена отвечать на однотипные запросы пользователей.
Кроме того, нельзя забывать и о психологическом аспекте. Постоянные пользователи продукта могут ждать исправления проблем, о которых они сообщали в техподдержку. Эта группа пользователей будет читать релиз ноутсы в надежде найти упоминание о своей проблеме.
Таким образом, релиз ноутс играют важную роль в коммуникации между разработчиками и пользователями, способствуя более эффективному внедрению и использованию новой версии ПО.
Написание релиз ноутс
Традиционно написание релиз ноутс и составление реестра изменений представлялось как очень кропотливая работа, для выполнения которой разработчикам приходилось внимательно отслеживать все изменения практически вручную. Учитывая, что разработчик – это свободный художник, для такого тяжкого «ремесленного» труда во многих компаниях даже ввели новую должность релиз-менеджера – человека, который должен разобраться в клубке запутанных историй изменений и сказать, наконец, что и как было изменено относительно прежней версии.
Сегодня эту функцию фактически выполняет программное обеспечение, такое как, например, GitLab Changelog API. В нем можно автоматически генерировать историю изменений (changelog) из существующего репозитория и выпускать релиз ноутс.
При этом для создания релиз ноутс активно используется искусственный интеллект. Он позволяет почти на 100% автоматизировать написание документации для обновлений продукта. Сначала ИИ собирает данные (сканирует коды на предмет изменений). Далее автор («условный автор» – человек, не ИИ) выбирает шаблон для создания релиз ноутс. Этим практически и ограничивается человеческое вмешательство в работу искусственного интеллекта за исключением, возможно, редактирования результата.
На третьем шаге ИИ генерирует текст. Происходит компиляция данных, ее структурирование согласно выбранному шаблону. В результате получается связный читабельный документ, который при желании можно отредактировать, чтобы довести его до идеального состояния.
При редактировании следует обратить внимание на следующие пункты – это поможет правильно расставить акценты и создать качественную документацию:
Следуя этим пунктам, Вы сможете написать качественную документацию:
- Введение. Перечислите внесённые изменения и цели данного обновления, например, повышение производительности, улучшение безопасности или добавление новых функций. Так пользователи поймут, что ожидать от новой версии продукта.
- Исправления. Опишите, какие именно проблемы были исправлены и как это может повлиять на пользовательский опыт.
- Новые функции и возможности. Здесь должен быть обзор каждой новой функции, описание того, как она работает и для чего предназначена.
- Улучшения. Цель этого раздела — объяснить, что изменилось в лучшую сторону, и какую выгоду это принесёт пользователям.
- Нерешённые проблемы. Укажите все текущие проблемы. Предложите временные решения, если таковые имеются.
- Заключение. В этом разделе необходимо подвести итоги, рассказать о планах на будущее, а также указать данные для обратной связи и ссылки на дополнительную информацию.
Эти подсказки касаются структуры будущего документа. Однако кое-что можно улучшить и с точки зрения оформления. Этот момент больше касается маркетинга – важной функции релиз ноутс, призванных привлечь внимание пользователя к обновленному продукту. В этом плане оформление релиз ноутс ничем не отличается от обертки и упаковки – элементов промоушена в составе старых добрых четырех P маркетинга (the 4 Ps of marketing – product, price, placement, promotion).
Например, в оформлении релиз ноутс Asana включены видео-сниппеты, которые помогают пользователям понять суть изменений. Релиз ноутс Basecamp отличаются обилием скриншотов, иллюстрирующих представленную информацию. Кроме того, в тексте используются тизеры для привлечения внимания к новым функциям. Docker наполнили свои релиз ноутс ссылками на релевантную информацию, что позволяет пользователям получать новые, более глубокие знания по желанию.
Комбинируя приведенные выше советы и примеры вы сможете создать качественные релиз ноутс, понятные и доступные любой аудитории.
Как создать релиз ноутс на платформе Документерра?
Платформа Документерра предоставляет все необходимые инструменты для создания и распространения релиз ноутс.
Создание нового документа. Платформа Документерра – это своеобразное пространство для коворкинга. Здесь можно создавать релиз ноутс, работая совместно. Каждая команда специалистов (разработчики, техрайтеры, редакторы, переводчики) может работать параллельно друг с другом. Например, разработчик пишет определённую часть кода, технический писатель описывает для пользователей функции и особенности программы (меняет программистский язык на человеческий), потом отдаёт текст редактору или продакт менеджеру – тот наводит порядок и придает общей работе финальный вид.
Версионирование. В верхней части документа можно указать номер версии и дату выпуска. Это поможет пользователям легко определить, к какому обновлению относится данный релиз ноутс.
Редактирование. Перед выпуском необходимо проверить все данные, чтобы убедиться в их точности и полноте.
Публикация документа. Документерра позволяет выполнять быструю публикацию – это одно из преимуществ онлайн-портала: здесь можно даже «допубликовать» недостающие материалы позже, если забыли что-то включить.
Также доступен экспорт в печатные форматы для продуктов, предполагающих скачиваемый файл или печатную версию.
Следуя этим шагам, Вы сможете быстро и эффективно информировать пользователей о всех обновлениях ПО.
Возможности версионирования в Документерре
Версионирование в Документерре позволяет отслеживать изменения в документации, управлять различными версиями и облегчает поддержание актуальности информации. Ниже представлены основные возможности версионирования в Документерре:
- Создание и управление версиями. Технические писатели могут переключаться между версиями для просмотра или редактирования. Кроме того, возможно автоматическое сохранение изменений с указанием времени и автора.
- История изменений. Система позволяет отслеживать изменения с указанием времени, автора и описания внесённых корректировок. Также доступна возможность просмотра истории изменений для каждой версии документа.
- Совместная работа. Платформа позволяет одновременно работать нескольким пользователям над различными версиями документации. Возможно отслеживание изменений, внесённых разными авторами, их согласование и объединение.
- Сравнение версий. В Документерре также можно сравнивать разные версии документации для выявления изменений. При этом добавленные, изменённые или удалённые части документа визуально выделяются в тексте. Это позволяет лучше ориентироваться в информации.
- Резервное копирование и восстановление. Резервное копирование всех версий документации выполняется автоматически. Имеется возможность восстановления предыдущих версий в случае необходимости.
- Публикация версий. Документерра предоставляет возможность публикации отдельных версий документации для пользователей. При этом администратор портала может управлять доступом к различным версиям.
- Управление тегами и ветками. Присвоение условных тегов различным версиям для их удобной идентификации. Создание веток для работы над параллельными версиями документации (например, работа над новой функцией или исправлением ошибок).
Эти возможности версионирования помогают поддерживать актуальность и целостность документации, облегчая работу над ней.
***
Релиз ноутсы и обновление документации необходимы для эффективного взаимодействия между разработчиками программного обеспечения и пользователями. Документ о релизе – показатель вашего профессионального подхода к информированию целевой аудитории о новых версиях цифрового продукта.
Релиз ноутс – это комплексная сводка изменений, включающая в себя новые функции, улучшения, исправления ошибок и прочие обновления. Значение релиз ноутс заключается не только в том, чтобы предоставлять пользователю ясную и полную информацию о новых возможностях. Релиз ноутсы имеют и маркетинговую функцию. Она состоит в том, чтобы сформировать лояльность клиентов, укрепить их доверия к ИТ-продукту и наладить взаимодействие между разработчиками и их аудиторией. Они служат ориентиром, помогающим пользователям освоить новые функции и получить максимальную выгоду от обновленного программного обеспечения. Создание и распространение релиз ноутс представляет собой важный этап в жизненном цикле продукта, направленный на обеспечение высокого уровня удовлетворенности пользователей и поддержания прозрачности в процессе разработки программного обеспечения.