You are right, the doc can be improved. I have forewarded your note to the doc folks.