(doc) clear up the confusion in the documentation