Skip to content

Commit

Permalink
Create word-usage.adoc
Browse files Browse the repository at this point in the history
word usage page - still prelim

Signed-off-by: Kersten Richter <[email protected]>
  • Loading branch information
kersten1 authored May 13, 2024
1 parent d2da543 commit 4a545a8
Showing 1 changed file with 23 additions and 0 deletions.
23 changes: 23 additions & 0 deletions src/word-usage.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
== Word usage

=== A words

Above - Avoid
Above, below, left, and right do not translate well to screen readers. Instead, use "previous or the "following".

After (once)
Use after to indicate a sequence of events. Use once to indicate one time.

Can (might, must, may, should, shall, will)
- Use "can" to indicate capability: "This option can cause your system to fail."
- Use "might" to indicate possibility: "This option might affect your system performance."
- Don't use "may," which is ambiguous because it could mean either capability or permission.
- Use "should" to indicate a recommended, but optional action. Consider using an alternative phrase instead, such as "we recommend." Do not use "should" to indicate something that might happen. "After you push the power button, the system should turn on." Instead, be bold! "After you push the power button, the system turns on."
- Use "must" to indicate a rquired action or condition. The system must be on.
- Use "shall" to indicate a requirement. "The system

If (whether)
Use if as a condition, such as logic. If a, then b.
Use whether to indicate choice or alternative. Event a happens, whether event b does or not.


0 comments on commit 4a545a8

Please sign in to comment.