functional requirements - use wording based on verbs?
Posted
by
yas
on Programmers
See other posts from Programmers
or by yas
Published on 2012-03-26T19:51:06Z
Indexed on
2012/03/26
23:38 UTC
Read the original article
Hit count: 241
Requirements
Question:
Should the functional requirements in a requirements doc use wording based on verbs?
Context:
School assignment, working in a team, working through the SDLC.
The requirements doc has been done and we are now into design.
Problem:
The requirements doc has an enumerated list of what I'd call features of the app - the functional requirements. In that list are things that I'd think of as "how's" rather than "what's" and now, trying to work on design, I feel like a part of design has been prematurely dictated.
I've not done this before! To me, I should be dealing strictly with things that describe "what."
Example of current:
Pretend that the job is to make an omelet. Listing: crack the egg, break into bowl, scramble, etc.; crosses over the line into the territory of how. Along that track, so does wording like: create, generate, list, calculate, determine, validate, etc. - verbs, basically. Right now, I have a list of requirements that are partially rooted in verbs.
My idea of a requirements doc for an omelet would be more like: has two eggs, x ounces of ham, x ounces of bacon, x ounces of montery-jack cheese, x ounces of cilantro, etc. - nothing but what (nouns).
I might have, and could have, spoken up before finalizing the requirements doc if I'd had any experience.
© Programmers or respective owner