Documenting requirements

21 views
Skip to first unread message

Беня

unread,
Aug 28, 2017, 4:29:24 AM8/28/17
to dotnetconf
Добрый день!

хочу расспросить о вашем опыте работы с требованиями (requirements)
В каком виде и куда записываете? Всё в одном структурированном документе?
Что-то типа Вики? WorItems в TFS?

У нас сейчас требования записываются в один большой документ (450 страниц), структурированный по юс-кейсам с точки зрения пользователя.
Документ по большей части создаётся до начала работ. В дальнейшем в него могут вносить изменения либо со стороны клиентов (например, переделывают бизнесс-процесс), либо со стороны разработки (прописывают неучтённый или ранее не определённый нюанс)

Проблема сейчас в том, что с таким документом неудобно работать:
- трудно бывает сразу определить, какие части уже реализованы, а какие нет. Потому что не всегда возможно сразу в 100% объёме реализовать use case.
- когда вносятся изменения, надо внимательно шерстить весть документ как для внесения правок, так и для считывания.

Alexander Byndyu

unread,
Aug 29, 2017, 12:30:24 AM8/29/17
to dotne...@googlegroups.com
Добрый день!

Мы записываем все требования в три вида карт. Подробное описание здесь https://byndyusoft.com/productanalysis

Документы не пишем, потому что они "плоские" и их приходится каждый раз парсить глазами.

--

---
Вы получили это сообщение, поскольку подписаны на группу "dotnetconf".
Чтобы отменить подписку на эту группу и больше не получать от нее сообщения, отправьте письмо на электронный адрес dotnetconf+unsubscribe@googlegroups.com.
Чтобы настроить другие параметры, перейдите по ссылке https://groups.google.com/d/optout.

Беня

unread,
Aug 29, 2017, 3:14:33 AM8/29/17
to dotnetconf, c...@byndyusoft.com
Александр, спасибо за ответ! Там всё очень интересно, но в статье разбираются довольно крупные куски.
Меня так же интересуют более детализованные описания.
Где описываются конкретные алгоритмы, бизнес-правила валидации и так далее?
Допустим, форма показывает табличку. Где описано в каких колонках какие данные откуда берутся?
Или если мы сохраняем что-то в БД. Где описано, в какие поля что писать?
Или это не требования, а как-то по-другому называется?

Alexander Byndyu

unread,
Aug 29, 2017, 3:20:09 AM8/29/17
to dotne...@googlegroups.com
Добрый день!

Мы никогда не описываем "в каких колонках какие данные откуда берутся" или "в какие поля что писать". Это задачи для разработчиков? В чем их ценность? Кто их пишет?

--

Беня

unread,
Aug 29, 2017, 3:44:03 AM8/29/17
to dotnetconf, c...@byndyusoft.com

Поясню на примере:

Есть должник, не оплативший счёт вовремя. На него заводится "дело", которое проходит разные этапы. В зависимости от текущего этапа и от того какие этапы уже были пройдены, в колонке "пеня" будет стоять та или иная сумма.
Если показываются неоплаченные проводки (бухгалтерские позиции), то в колонке "дата" показывается дата, взятая из базы данных счетов, а не из оперативной базы проводок.
Выбор самих этих неоплаченных открытых проводок, какие вообще должны показываться пользователю, тоже непрост и зависит от многих факторов.
Для того чтобы "дело" перешло к следующему этапу, надо проверить 20 условий. Где это всё описывается? Это доменные знания, важные и для разработчиков.

Alexander Byndyu

unread,
Aug 29, 2017, 4:01:46 AM8/29/17
to dotne...@googlegroups.com
Добрый день!

В этом описании переплетены истории и задачи, которые связаны с историями. Историю лучше записать в User Story Mapping, требования записать в тесты.

Если вам надо описывать бизнес-логику, чтобы ставить формальные задачи разарботчикам, то скорее всего подойдет Jira или YouTrack. Если вам надо вести документацию по системе, то видимо подойдет wiki. Но мы предпочитаем тесты, как документацию.

--

Беня

unread,
Aug 29, 2017, 6:05:39 AM8/29/17
to dotnetconf, c...@byndyusoft.com
ок, тогда так поставим вопрос. Если у меня каша в голове - (истории, задачи -- какая разница?), помогите сориентироваться по данной теме. Что подчитать?
Спасибо!

Alexander Byndyu

unread,
Aug 29, 2017, 7:50:34 AM8/29/17
to dotne...@googlegroups.com
Добрый день!


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

И сама книга интересно написана. В ней на самом деле полезные идеи.
2017-08-29 15:05 GMT+05:00 Беня <jewgeni...@gmail.com>:
ок, тогда так поставим вопрос. Если у меня каша в голове - (истории, задачи -- какая разница?), помогите сориентироваться по данной теме. Что подчитать?
Спасибо!

--
Reply all
Reply to author
Forward
0 new messages