Внутренняя документация — это договор между разработкой и менеджментом о том, что необходимо выполнить и в каком виде.
Прочие функции на самом деле вторичны: хранение истории изменений требований к системам, история поиска решений, история возражений и зафиксированных ограничений и всё прочее лишь дополняет первую и самую важную часть.
Документация создаёт определённость для разработки и для менеджмента, фиксируя наполнение работ хотя бы на ближайший спринт.
Не очень важно, продуктовая или проектная деятельность у компании.
Важно именно закрепление ожиданий.
Системный аналитик с такой точки зрения (это не единственная и не самая важная точка зрения, но одна из определяющих требования к профессии) выполняет роль юрисконсультанта в другой области знаний. Там, где юрисконсультант определяет законность проекта и выставленных к нему требований и обозначает легальные риски, а так же законные возможности, системный аналитик работает с описание функциональности систем и их взаимодействия (на уровень ниже системного архитектора).
Ровно как работу бэкенда часто можно свести к перекладыванию JSON в записи в БД, а записи в БД в XML; или работу фронтенда можно привести к правилам формирования JSON из данных, введённых пользователем в форме (или отображения данных, полученных в JSON от бэка в интерфейсе), работу системного аналитика можно свести к правилам перекладывания JSON’ок.
Но делать это не нужно. Аналитик фиксирует социальный контракт в рамках конкретного проекта или продукта на конкретный временной промежуток.
Выводы
- Добиваться «подписи». У документации (backlog, спецификация) должно быть явное согласие ключевых стейкхолдеров: «Да, я обязуюсь по этим условиям».
- Вести «протокол разногласий». Вторичная функция аналитика — история изменений, возражений, ограничений — это не архив, а прецедентное право. Она позволяет в будущем быстро разрешать споры, ссылаясь на уже принятые решения.
- Говорить на языке сторон. С бизнесом — о ценности, метриках, проблемах пользователей. С разработкой — о логике, данных, состояниях системы. Аналитик — переводчик между оргструктурами.
- Ценить свою роль. Аналитик — не overhead (накладные расходы), а страховка от рисков недопонимания, которая экономит команде сотни часов и бизнесу — тысячи (если не миллионы) рублей.