I think you are confusing the component doc and the API doc. This description of the class fits better for the API doc by putting it in the phpdoc of the class.