Differences

This shows you the differences between two versions of the page.

--- 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? ======
-<WRAP todo>Work in progress</WRAP>
+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 "gemba": In other words, actually seeing what people are doing
+  - 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 "written" English to communicate requirements, because written English is open to different interpretations. 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:
   * __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
-More words will often add to the problem, not make it simpler.
+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>Consultant Tools UserStory Stories FAQ ToDo FirstSprint}}
+{{tag>Consultant Tools UserStory Stories FAQ FirstSprint}}