Seilevel
Seilevel Home
Back to Blog Home - Requirements Defined

Tuesday, November 06, 2007

Words are hard

To put it bluntly, requirements text is typically pretty bland to read. You don’t get the colorful variety of writing in passive voice, because it can confuse the audience. But also, you have to pick your words very carefully. English is actually quite challenging, in that words have different meanings.


There is a concept called Garden Path Sentences that illustrates this well. And the essence of it demonstrates how people read sentences one word at a time. If something doesn’t make sense in your intuitive first reading, you have to back up and re-read it. The example they give is:




The horse raced past the barn fell.


Technically this is a correct sentence, but it takes two readings to have it make sense.


This certainly something we want to avoid in writing requirements, and so we write in active voice with simple obvious word choices. Bland yes…but also very practical!

Requirements Defined Newsletter Bookmark and Share

2 Comments:

Anonymous Anonymous said...

Languge in requirements statements is not hard because of the way they are written. They are hard because the underlying meaning was compromized long before you committed that meaning to paper.

Last week I was talking to the new product manager. I was trying to explain that a product derives its value from the extent of which a product breaks or loosens a constraint. He tells me that there is no such thing as a product. Everything is a service.

It turns out that he is a programmer, and I'm a marketer. He is talking black box stuff. He is not talking economic value. But, before I realized the cultural conflict in our discussion, I wouldn't have been able to write it down in a way that makes sense.

RE has always ignored culture, which means that RE ignores meaning. The goal was always developer efficency. User efficenty didn't matter, and here we are talking about interfaces and views, but rather models RE corrupts models.

When you mess with meaning, you mess with thinking.

11/07/2007 9:49 AM  
Blogger Joy said...

I've posted this on the messageboard where we can discuss it further!

http://www.seilevel.com/messageboard/showthread.php?p=3513#post3513

11/12/2007 8:14 PM  

Post a Comment

<< Home