Каков правильный способ создания документов требований?

Каков правильный способ создания документов требований?
Каков правильный способ создания документов требований? - pokornymichal @ Unsplash

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

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

Я весьма удивлен, что до сих пор никто не рекомендовал использовать вики для отслеживания требований.

Я считаю, что это почти идеальная система, потому что:

  • Она позволяет людям сотрудничать над требованиями и делает этот аспект очень заметным;
  • Она позволяет легко поддерживать требования в актуальном состоянии по мере продвижения проекта;
  • Вы можете в любой момент зайти и посмотреть историю, если возникнет спор "мы так не договаривались";
  • Большинство современных вики имеют достойные возможности форматирования, так что это выглядит почти так же хорошо, как документ Word;
  • Вы можете делать гиперссылки непосредственно из ваших требований в реальную документацию;
  • Вам никогда не придется беспокоиться о том, что люди работают с разными/устаревшими копиями;
  • Требования можно начать рассматривать как итерационный процесс, такой же, как проектирование/реализация;
  • Если требования становятся очень большими/сложными, их легко разделить по страницам/темам.
  • Большинство вики принимают HTML, так что если вам действительно нужно продвинутое форматирование, вы можете использовать инструмент типа Windows Live Writer.

Если есть выбор, я почти всегда выбираю метод вики, это действительно довольно безболезненно по сравнению со старомодными документами Word или попытками впихнуть все это в багтрекер.


LetsCodeIt, 21 мая 2023 г., 09:06

Похожие посты