brush up docs - avoid confusion