Pattern or AntiPattern?
Forces:
This may or may not be a reasonable pattern for making presentations. But for documentation intended to be written by developers, it just aggravates the annoyance with unnecessary redundancy.
Templates of the RationalUnifiedProcess exemplify this GrayPattern?.
Steps toward refactoring such documentation/templates:
This exact issue is raised in a Christian context in a book named The Homiletical Plot by Eugene Lowry, in which the author recommends narrative (that is, storytelling) sermons rather than tell-it-to-them-three-times sermons. For an excellent summary, see:
What makes you think this is an AntiPattern? List the expected benefits and the actual (negative) consequences. If you can, describe three unrelated projects that experienced the consequences.
Thanks for prodding me: as you can see from the name change, I've decided it's really a GreyPattern - it may well be useful if you're doing a presentation to bored people who don't want to think too hard. As for concrete examples, almost every document template in RUP (and every other methodology I've seen) has this kind of redundancy. -- tr
Jim - great refactoring! So far it's 2 to zero for AntiPattern (or GreyPattern) - anybody have anything positive to say for it? -- tr
Thanks, Tom. But the score I see is zero to zero: zero primary-source examples of the pattern succeeding, and zero primary-source examples of the pattern failing. Also, to be an anti-pattern, there has to be a negative consequence. What is the negative consequence of SayItThreeTimes? -- JimLittle
Your audience gets bored, and does not retain the information being presented. Good question, though, and thanks for prompting that thought. I've added a "Negative Consequences" section as a result. -- BrentNewhall
Point taken, Jim. I believe another negative consequence is that programmers don't do documentation, do it desultorily, and/or don't keep it in sync with code. But I can't point to specific instances that prove that claim, so I'm not adding it to the Negative Consequences section. -- TomRossen
SayItThreeTimes is effective when you concentrate on providing 3 interdependent messages.
First, you provide a focusing statement telling why you are presenting the information. Second, you provide underlying details to support the initial statement. Without the first statement, the details often appear confused and unrelated to the audience. Third, you provide a request or suggestion on what to do with the information just provided. These 3 things are related, but not redundant.
To use SayItThreeTimes effectively, tell the audience what the issue is, tell them why it is an issue, and tell them how you want them to address the issue.