Re: [PHP-DEV] PHP7 and types - and alternatives to annotation

2015-07-13 Thread Marco Pivetta
On 13 July 2015 at 13:23, Lester Caine les...@lsces.co.uk wrote: On 13/07/15 13:12, Marco Pivetta wrote: It's actually the PhpDocumentor folks (and Mike van Riel in first place) pushing forward PSR-5: there's nothing more official than that right now. That's the current standardization

Re: [PHP-DEV] PHP7 and types - and alternatives to annotation

2015-07-13 Thread Lester Caine
On 13/07/15 08:49, Pierre Joye wrote: No, not just my IDE can work. IDE is just the side effect. Proper documentation does much more than that. It seems to go off topic. Docblocks are only slightly related to this thread. The same could be said about annotation (which are widely used too).

Re: [PHP-DEV] PHP7 and types - and alternatives to annotation

2015-07-13 Thread Marco Pivetta
Hi Lester, On 13 July 2015 at 11:36, Lester Caine les...@lsces.co.uk wrote: On 13/07/15 08:49, Pierre Joye wrote: No, not just my IDE can work. IDE is just the side effect. Proper documentation does much more than that. It seems to go off topic. Docblocks are only slightly related to

Re: [PHP-DEV] PHP7 and types - and alternatives to annotation

2015-07-13 Thread Lester Caine
On 13/07/15 11:51, Marco Pivetta wrote: Please refer to https://github.com/php-fig/fig-standards/pull/169 This just adds another level of complication. FIG is not part of the core PHP standards, and some of their choices simply don't fit with legacy code. I suspect that some of the problems I'm

Re: [PHP-DEV] PHP7 and types - and alternatives to annotation

2015-07-13 Thread Rick Widmer
On 7/13/2015 4:36 AM, Lester Caine wrote: Coming from a background of 'traditional' php design, all of my code and the libraries I use are documented via phpdoc style annotation which the IDE picks up, and phpdocumentor1 produced a good API description. This was also a GOOD basis to tidy up the

Re: [PHP-DEV] PHP7 and types - and alternatives to annotation

2015-07-13 Thread Marco Pivetta
On 13 July 2015 at 12:20, Lester Caine les...@lsces.co.uk wrote: On 13/07/15 11:51, Marco Pivetta wrote: Please refer to https://github.com/php-fig/fig-standards/pull/169 This just adds another level of complication. FIG is not part of the core PHP standards, and some of their choices

Re: [PHP-DEV] PHP7 and types - and alternatives to annotation

2015-07-13 Thread Lester Caine
On 13/07/15 13:12, Marco Pivetta wrote: It's actually the PhpDocumentor folks (and Mike van Riel in first place) pushing forward PSR-5: there's nothing more official than that right now. That's the current standardization path. docblock annotation has been the subject of RFC's as alternatives