I ended my post on popularity and ambiguity by promoting the benefits of a glossary of terms. This post will continue to explore the problems of ambiguity associated with natural language.
In addition to establishing a glossary, another way of ensuring consistency across features, is to employ a standard template for describing features. I have long promoted goal-oriented descriptions for features and base my feature descriptions on a simple verb-noun template.
The verb part of the template either describes some action that can be performed by a user of the product; or some internal function of the product. The noun part of the template describes the object (or target) of the action. Together, the verb and noun describe some action that must be perform to achieve a goal.
In addition to establishing a glossary, another way of ensuring consistency across features, is to employ a standard template for describing features. I have long promoted goal-oriented descriptions for features and base my feature descriptions on a simple verb-noun template.
The verb part of the template either describes some action that can be performed by a user of the product; or some internal function of the product. The noun part of the template describes the object (or target) of the action. Together, the verb and noun describe some action that must be perform to achieve a goal.
- Enter reservation
- Amend reservation
- Cancel reservation
- Add accommodation charge
- List guests
- Accommodation: A temporary place to stay. May be provided by a room, suite, chalet or dormitory.
- Guest: A person who occupies accommodation at a hotel.
- Reservation: The arrangement by which accommodation is secured in advance of a stay.
Qualifying Features
It is often necessary to further qualify the nouns included in feature descriptions. One way to do this is by adding additional nouns (or noun phrases) that clarify the object of the verb. These additional nouns may be drawn from existing glossary definitions or, depending on how frequently they are used, they may require their own glossary entries.
It is often necessary to further qualify the nouns included in feature descriptions. One way to do this is by adding additional nouns (or noun phrases) that clarify the object of the verb. These additional nouns may be drawn from existing glossary definitions or, depending on how frequently they are used, they may require their own glossary entries.
- Enter accommodation reservation
- Add accommodation charge to guest’s account
- List dormitory guests
- Enter new reservation
- Amend existing reservation
- Cancel duplicate reservation
- Add provisional accommodation charge
- List overseas guests
- Manually cancel reservation
- Automatically add accommodation charge
- Periodically list guests
- Cancel reservation if the guest is a no-show
- Add accommodation charge at 2am each day
- List guests that checked in last week
Basing feature descriptions on the verb-noun template, coupled with careful qualification of verbs and nouns, can help to remove ambiguity from the features.
- Enter new accommodation reservation
- Amend existing accommodation reservation
- Manually cancel duplicate accommodation reservation
- Automatically cancel accommodation reservation if the guest is a no-show
- Automatically add provisional accommodation charge at 2am each day
- Periodically list overseas guests that checked in last week



