updated documentation as per suggestion by @Shiftkey