(doc) adding more information in the comments