On 27/04/16 21:11, Fleshgrinder wrote: > It is about natural language, proper computer > science terminology, and what PHP users will search for in search > engines.
To add to your list ... https://www.phpdoc.org/docs/latest/guides/docblocks.html The glossary entry is rather bare, but I would dispute THEIR statement - "but also influences the way the application behaves." In my book, these comment blocks are 'annotation' is it's simplest form, and we add tags within that annotation to make particular details of that annotation both machine readable and humanly prominent. That some of these keys may be used to "influences the way the application behaves." is secondary? My continuing irritation is that while subsets keep getting discussed as duplicate elements outside of the phpdoc wrapper, there is no provision for the annotations that would actually help data validation. -- Lester Caine - G8HFL ----------------------------- Contact - http://lsces.co.uk/wiki/?page=contact L.S.Caine Electronic Services - http://lsces.co.uk EnquirySolve - http://enquirysolve.com/ Model Engineers Digital Workshop - http://medw.co.uk Rainbow Digital Media - http://rainbowdigitalmedia.co.uk -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
