Update documentation for clarity

Fixes bug #1393908

Change-Id: Iec46949f9f4beb25d6818b6b141de78180630a60
Merge "Update documentation for clarity"