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: 214

Filed under:

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

Related posts about Requirements