Путь аналитика от получения пожеланий бизнеса до подготовки ТЗ для разработчиков: на примере реального кейса

В этой статье на реальном кейсе я хочу рассмотреть весь путь превращения требований от бизнес-заказчика в техническое задание для разработчиков. Кроме того, в отдельных врезках я буду приводить объяснение той или иной технологии, того или иного понятия…

Оформляем приложения по ГОСТ 7.32 в MS Word и не только

В статье предложены некоторые приемы форматирования текста, которые могут существенно облегчить оформление документов, разрабатываемых по ГОСТам, техническим писателям и всем, кто занимается разработкой таких документов. Подходы к автоматизации формати…

[Перевод] Почему современная документация к коду — просто мусор. И как это исправить

Когда вы в последний раз сталкивались с качественно документированным кодом?С кодом, который можно было использовать буквально «из коробки», просто ознакомившись с небольшим README файлом. Но к которому в то же время прилагалась подробная документация,…

28 расширений VS Code для разработки документации

Плагины Vs Code, без которых техническим писателям и разработчикам документации жить можно, но сложно. В подборке — линтеры, форматирование, работа с git, проектирование API, подготовка схем и милота для удобной разработки. Читать дальше…

Ошибки технарей, которые пишут документацию для разработчиков

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

Как начать моделировать бизнес-процессы в BPMN

Анна Вичугова, CBAP, написала стартовое пособие по тому, как начать моделировать бизнес-процессы в BPMN1. Назначение BPMN2. Уровни моделирования3. Алфавит нотации: События, Логические операторы, Артефакты4. Правила построения диаграмм5. Пример построен…

Как бороться «темами» в документе MS Visio

В MS Visio начиная с версии 2007 появилась возможность называемая «темы» (со слов разработчиков она предназначена «для придания схеме профессионального вида»)… В этой статье вы узнаете как удалить «нежелательное влияние» тем в документах MS Visio. Уви…

Трудности в определении пользователя ИС: советы начинающим аналитикам

Одним из первых шагов при написании ТЗ на разработку ИС является выявление будущих пользователей системы. Казалось бы: ничего сложного, но бывают нюансы.Давайте начнем с теории. Согласно Карлу Вигерсу существует множество заинтересованных лиц:«Заинтере…