Proposal for inline documentation

See guideline: https://github.com/phpDocumentor/fig-standards/blob/master/proposed/phpdoc.md