General Requirements Guidelines - Simm Section 170a - California Department Of Technology Page 7
ADVERTISEMENT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18Table 2: Examples of Grammar Use
Poor Grammar
Better Grammar
The user presses the Delete key.
Press the Delete key.
(Result: The customer details will be
(Result: The customer details are displayed.)
displayed.)
Starting the batch job starts the report. (This
Start the batch job to generate the report.
is Indicative, not imperative)
(This is imperative mood, active voice, and in
The report is generated by starting the batch
second-person)
job. (This is Passive voice; not Active)
The operator starts the batch job to generate
the report. (This is Third-person; not Second-
person)
Subject/Verb Agreement
The subject and verb must always agree in number. Singular verbs should be used with singular
subjects and plural verbs with plural subjects. An error in number is easy to make when a
sentence is long and complicated. The singular subject of a sentence can be confused with a
plural identifier.
Parallel Construction
Good grammar also requires the use of identical style in both parts of a compound subject or
predicate. The use of identical style in a series of nouns, adverbs, or prepositional phrases is
also recommended.
2.4 Vocabulary
Select words carefully and use them for their precise meaning. Use conventional terminology
when defining requirements. When unique terms are used, provide the definition of said term(s)
and appropriately submit the terms to the project glossary. Once a word is selected, use it
consistently throughout the solicitation document whenever the same meaning is intended. The
following are some examples of commonly misused or ambiguous terms along with guidelines
for their recommended usage in project documentation and resulting contracts.
California Department of Technology
6
SIMM Section 170A
General Requirements Guidelines
August 2016
ADVERTISEMENT
0 votes
Related Articles
Related forms
Eligibility Complaint Of Discrimination Under The Provisions Of The California Fair Employment And Housing Act Template- California Department Of Fair Employment And Housing
Legal
Related Categories
Parent category: Legal