updated documentation notes