Word choice
Instead of this word, use "can", "might", or, in some cases, "could".
What is may?
Use this before lists and codeblocks but not before tables and images.
What is a colon?
When telling a user character limits for password creation, write them this way.
What is numerical?
All charts, diagrams, and illustrations must have this.
What is a complete description of the data that they contain?
Instead of single signon.
What is single sign-on?
Allow list and deny list have taken the place of these terms.
What are whitelist and blacklist?
Identify what specifically is missing in the following sentence:
I'd like to thank my parents, God and Ayn Rand.
What is the Oxford comma?
Indicate a range of numbers using this.
What is a hyphen?
Keep your short alternative text condensed to this many characters.
What is 150?
Instead of multifactor authentication.
What is multi-factor authentication?
What is Latin?
This sentence splitter isn't used in Ping Identity documentation.
What is the semi-colon?
Because of our global audience, do not write dates this way.
What is numerical?
These are the globally-approved recommendations for making web content accessible.
What are the Web Content Accessibility Guidelines (WCAG) 2.1?
Instead of checkbox.
What is check box?
You might use this word as a contrast in other writing circumstances, but at Ping, we only use this one to indicate that something is being done concurrently or simultaneously as another action.
What is while?
If even one item in your list is a full sentence, make sure that every item in your list has one of these.
What is a period?
Order dates according to this country's standard format.
What is the United States? (month, day, and year. For example, July 6, 2023)
Captions must be used for any content of this type.
What is multimedia?
Instead of key/value pair.
What is key-value pair?
Frequently in our product docs, we make recommendations to users about preferred settings and how to configure Ping software securely. Instead of the passive voice form, a user knows that something is recommended when we say ______.
What is you should?
Identify the part of speech in this sentence that you should remove for the sake of minimalism:
The configuration framework does not allow you to remove objects that are referenced, and in some cases if you have one configuration object referencing another but really do not need it, then you must first remove the reference to it.
What is an adverb?
If a series contains numbers less than ____ and greater than ____, use numerals for all numbers.
In some locales, failure to provide accessible content might violate these.
What are accessibility laws and regulations?
Instead of driver's license.
What is driver license?