Недавно уволился из одной очень большой организации, где не только разработчик не участвует в проработке задачи, но и архитектор. Не, формально, конечно, они на PBR присутствуют, но когда доходит до тех. тонкостей - все резко становятся недоступны и перегружены. В итоге аналитик там додумывает ещё и за внешнюю систему, с которой коммуникации не налажены, либо у которой доработка стартует сильно позже и им сейчас её обсуждать неинтересно. К чему я клоню... Шаблон не столь важен, сколько процесс.
Удачный шаблон документации на API, который будут читать
Недавно уволился из одной очень большой организации, где не только разработчик не участвует в проработке задачи, но и архитектор. Не, формально, конечно, они на PBR присутствуют, но когда доходит до тех. тонкостей - все резко становятся недоступны и перегружены. В итоге аналитик там додумывает ещё и за внешнюю систему, с которой коммуникации не налажены, либо у которой доработка стартует сильно позже и им сейчас её обсуждать неинтересно. К чему я клоню... Шаблон не столь важен, сколько процесс.