Thanks for your comments, this is really good advice! I have created issue https://github.com/phpDocumentor/phpDocumentor2/issues/881 to implement this