Hello everyone, Over the last few weeks, I blew the dust off of many leftover conversations from PSR-5's first effort, housed in a fork of the FIG repo that lived in the phpDocumentor organization [1]. There were lots of old discussions on Issues and Pull Requests there. I was able to stir up some new conversation on many of them, from Working Group members [2] and other Contributors At Large.
FIG Guidelines call for all discussions to stay here on this Google Groups mailing list, so going forward, that's where Requests For Comments will be initiated. The Working Group itself might have some internal discussions, but results coming from those will generally be highlighted in new ML topic threads (as well as mentioned by these weekly updates). The fork at phpDocumentor is now shut down as far as the workflow for these PSRs, but is still available for perusal and background research. Currently, there are several Pull Requests [3] at the FIG repo that are designed to only be updates to the doc files to establish an uncluttered baseline of specs and tags. These are corrections and cleanups, so they are not expected to require much discussion, and are awaiting WG reviews. On the ML, we have several open threads of discussion [4]. Everyone interesting in contributing to discussions should get involved on these threads. My plan for the next week is to work more directly on establishing the smallest baseline of doc content as I can, so that we have consensus around an uncontroversial starting point. I will be communicating with the WG on the tags in PSR-19 and how their represented implementations see them currently. Once the baseline tag catalog is in a state that the WG implementations agree with, we'll check the PSR-5 spec doc to make it minimally match what the tag catalog requires. From these two cleaned up baselines, discussions on changes will have a better reference point. Aside from contributing, if you have feedback on the structure or content of this update email, please let me know. Chuck Burgess, Editor *about.me/ashnazg <http://about.me/ashnazg>* [1] -- https://github.com/phpDocumentor/fig-standards [2] -- https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-meta.md#5-people [3] -- https://github.com/php-fig/fig-standards/pull/1097 -- "Downstream changes from phpDocumentor/fig-standards fork" https://github.com/php-fig/fig-standards/pull/1099 -- "revert deprecation of link tag" https://github.com/php-fig/fig-standards/pull/1101 -- "simple fix of 4.3 section headings" https://github.com/php-fig/fig-standards/pull/1102 -- "remove references to generics" [4] -- https://groups.google.com/forum/#!topic/php-fig/KckIDHss-QI -- "PSR-19] deprecate double closing brace on inline internal tag" https://groups.google.com/forum/#!topic/php-fig/5A5ytQyV6Oo -- "[PSR-5] Nullable type shorthand in PHPDoc (e.g. `@return ?string`)" https://groups.google.com/forum/#!topic/php-fig/zFMcfjYAS7M -- "PSR-5] Variadic Parameters" https://groups.google.com/forum/#!topic/php-fig/vi0ymMCydDA -- "[PSR-5][PSR-19] Is there a way to annotate interface that acts as iterator over some type?" -- You received this message because you are subscribed to the Google Groups "PHP Framework Interoperability Group" group. To unsubscribe from this group and stop receiving emails from it, send an email to php-fig+unsubscr...@googlegroups.com. To post to this group, send email to php-fig@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/php-fig/CANsgjntyrrU1fc9Gj9iO5tF2RQp_Zbmu_-5AO19UMGVB0dWSNQ%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
