Working Group, Given one approval on the first four tags (api, author, copyright, todo), the PR to mark them approved is ready for your review [1]. Also, the last "cleanup / from-old-fork" PR [2] still needs an approval so that I can pull in that last batch of changes.
In looking over my initial notes on all the remaining tags, I'm thinking these four will be the easiest to discuss next: * category [3] - Rather than list it as deprecated, should be just leave it out altogether? * deprecated [4] - The syntax already contains the Ending Version... should we take that out? I don't know that the merits of including it was ever justified. * global [5] - I definitely think we should leave this out... let @uses do its job. * license [6] - If we decide to drop file-level docblocks altogether, should the license tag even continue to exist? Do we really want to license elements individually? Please consider my questions and reply. For any of these tags that you do feel should remain in the catalog, please look specifically at those sections and decide: - does anything need to be removed - is any wording unclear - does it *not* fit with *your* implementation Lastly, as mentioned before, please join the ML discussions as you are able. CRB *about.me/ashnazg <http://about.me/ashnazg>* [1] -- https://github.com/php-fig/fig-standards/pull/1113 -- "[PSR-19] mark four tags as approved by WG" [2] -- https://github.com/php-fig/fig-standards/pull/1109 -- "Downstream changes from phpDocumentor/fig-standards fork" [3] -- https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#53-category-deprecated [4] -- https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#55-deprecated [5] -- https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#57-global [6] -- https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#59-license On Wed, Oct 31, 2018 at 12:56 PM Chuck Burgess <[email protected]> wrote: > Ok, Working Group, let's start small... > > I've gone through the tag catalog (phpdoc-tags.md), and made notes on each > tag as it is *currently* shown in the catalog. > > I see these tags as being perfectly fine, needing no changes: api [1], > author [2], copyright [3], todo [4]. > > I'd like the group to look specifically at those sections only, and decide: > - does anything need to be removed > - is any wording unclear > - does it *not* fit with *your* implementation > > As we reach consensus on each section, I'll do a PR to mark the section as > "approved by WG"... these markers will be removed before the acceptance > vote. > > Once we're past this step, I'll bring up specific things on another tag > section or two. This way, we keep the amount of open topics from getting > unwieldy. > > Granted, the amount of ML threads is beyond such control, so join those > discussions as you are able. > > Does this approach sound ok to the WG? > CRB > *about.me/ashnazg <http://about.me/ashnazg>* > > > [1] -- > https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#51-api > [2] -- > https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#52-author > [3] -- > https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#54-copyright > [4] -- > https://github.com/php-fig/fig-standards/blob/master/proposed/phpdoc-tags.md#520-todo > -- 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 [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/php-fig/CANsgjnu9NmvreVt0BiUBE7ota6RUpEfMdWLr6CfisOTq8%2B7-6w%40mail.gmail.com. For more options, visit https://groups.google.com/d/optout.
