why_don_t_we_use_written_english_to_communicate_requirements
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
why_don_t_we_use_written_english_to_communicate_requirements [2018/12/03 19:37] – Added todo hpsamios | why_don_t_we_use_written_english_to_communicate_requirements [2021/01/05 12:09] (current) – Add 'get everyone involved' hans | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Why Don’t We Use Written English to Communicate Requirements? | ====== Why Don’t We Use Written English to Communicate Requirements? | ||
- | <WRAP todo> | + | A base assumption of Agile is that understanding of requirements is best achieved by: |
- | Consider the sentence “Mary had a little lamb” and think about all the meanings this could have based on where you put the emphasis on the sentence: | + | - Going to the " |
+ | - Talking about the need: In other words, asking questions and working through examples and assumptions | ||
+ | - Getting everyone involved right at the beginning - product management, architects, testers, developers, and designers. | ||
+ | |||
+ | In particular, we try to avoid using " | ||
* __Mary__ had a little lamb - it was Mary's lamb, not John's | * __Mary__ had a little lamb - it was Mary's lamb, not John's | ||
Line 11: | Line 15: | ||
* Mary had a little __lamb__ - she didn't have the curried chicken like everyone else | * Mary had a little __lamb__ - she didn't have the curried chicken like everyone else | ||
- | More words will often add to the problem, | + | You can see a shift in your emphasis while reading will potentially change the whole meaning of the sentence. Further, more words will often add to the problem. |
+ | |||
+ | And finally traditionally there is usually a series of documents that are used to produce different levels of documentation before the Team gets to work on them. Requirement documents lead to design documents and detailed design documents, which are then reinterpreted into testing documents and so on. Now we are compounding misunderstanding on misunderstanding. Is it any surprise that we might end up producing something that has no use to the person who asked for the capability? | ||
- | {{tag> | + | {{tag> |
/home/hpsamios/hanssamios.com/dokuwiki/data/attic/why_don_t_we_use_written_english_to_communicate_requirements.1543894669.txt.gz · Last modified: 2020/06/02 14:24 (external edit)