Rules defined by MSTP for technical documentation.
(Disclaimer! Always use your company’s house style guide if available)
Words to Avoid
Alias Correct Usage – The tool lets users create, copy, and manage instances using unique alias for easy identification within the network. Incorrect Usage – To log in please enter your account name or alias along with your password. Click for details.
Allow/Allows Correct Usage – Pay-as-you-go allows you to share apps and Power Automate flows with any user in your organization and then only pay if and when they’re used. Incorrect Usage – Microsoft Excel allows users to copy and paste information directly. Click for details.
And so on Correct Usage – Vibrant colors such as Red, Yellow, and Orange suit their brand image. Incorrect Usage – Vibrant colors suit their brand image, for example, Red, Orange, Yellow, and so on. Click for details.
and/or Correct Usage – You can change your password or keep it exact. Incorrect Usage – You can change your password and/or keep it exact. Click for details.
Application file/app file Correct Usage – I downloaded the latest version of the app and I have to check for the program file to install it. Incorrect Usage – To run the software you need to locate the application file / app file on your computer Click for details.
“Try things out, be happy to make mistakes, but above all have a go.” - Charles Dowding
No Comments