Reference: Do you use the correct symbols when documenting instructions?
  v2.0 Posted at 2/05/2016 6:06 PM by Joanna Feely
​​​An important area which Microsoft does not apply strict standards to, is documenting instructions. This is often a confusing dilemma for many people, as the way in which instructions are worded and arranged is very important in helping the user understand the instructions. Therefore, the instructions should be minimalistic, clear and concise.

​In Ken Getz's words you MUST ALWAYS list the items in the order the user selects them. I often see on Microsoft documentation: 'Select All Programs from the Start menu'. That's inexecusable!​

Click Start, then All Programs, then Accessories, then Calculator.

Figure: Bad Example - No visual cue is given for separate steps

Start - All Programs - Accessories - Calculator

Figure: Bad Example - Dashes are easy to glance over

Start --> All Programs --> Accessories --> Calculator

Figure: Bad Example - This is better but looks unprofessional

Start | All Programs | Accessories | Calculator

Figure: Good Example

We have a program called SSW Link Auditor​ to check for this rule. We offer a rule sample pag​e​ for demo scan.​​

Related rules

    Do you feel this rule needs an update?

    If you want to be notified when this rule is updated, please enter your email address:


    Note: Social Media login for Yotpo is not working in IE or Safari, please use Chrome. We are waiting for Yotpo to fix it.