Correct Modal Verbs
Use modal verbs to express ideas such as ability, uncertainty, necessity and permission.
- Can — relates to present ability and general possibility.
- Could — relates to possibility and suggestion.
- May — relates to probability and permission. It also means that an item is optional.
- Need — relates to the absence of obligation. In technical documentation, this verb is used only as a synonym for the verb want.
- Must — relates to personal obligation. It means that the definition is an absolute requirement of the specification.
- Must not — relates to the absence of personal obligation. It means that the definition is an absolute prohibition of the specification.
- Have to — relates to impersonal obligation. Do not use it as a synonym for the verb must.
- Should — relates to expectation and recommendation. Do not use it as a synonym for the verb must.
Important |
We do not use the modal verbs shall, might, would and ought to in Veeam technical documentation. |
To learn more about key words used to indicate requirement levels, see RFC 2119.
Examples
- Orchestration plans can be scheduled and chained to execute in sequence. [general possibility]
- By design, you cannot customize the default template itself. [present ability]
- A situation where you attempt to monitor too many vSphere hosts and VMs could overload the Ops Mgr Health Service and thus result in unstable operation and possible monitoring outage. [possibility]
- You may need to add new VM groups or remove some groups from an orchestration plan. [probability]
- If you need to monitor the state of a specific service, you can create and customize a vSphere Host Service Monitor. [want]
- To create orchestration plans, you must first categorize VMs into VM groups to be used in these plans. [personal obligation]
- At the Resource Usage step, specify the datastore capacity level that must not be breached during the recovery process for orchestration plans to complete successfully. [prohibition]
- You do not have to select every single monitor or rule. Just select the object that the monitors run against. [impersonal obligation]
- The Default Backup Restore IAM role should be created automatically after you perform these steps. [expectation]