Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:93010
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.220.45 as permitted sender)
To: Rowan Collins <rowan.collins@gmail.com>, internals@lists.php.net
References: <BY2PR0201MB178479B3AF8BD49583233034BF6E0@BY2PR0201MB1784.namprd02.prod.outlook.com>
 <CAFKaYMqg6H2YAgS-ATjcYtXw8GLbp_Kr+VuZFMRPZTkAS1g0hA@mail.gmail.com>
 <571965D1.9020102@zend.com>
 <CAFp73Xs=-sK4ZM-mM8Jp5wWkpYLuen+-K0R9xfZaumBM_sPPFw@mail.gmail.com>
 <5719CDB2.90103@zend.com>
 <CAFp73XtqBtLdoTykrg_1eeJZTFszcmutNpynmyGKEizPiC2Juw@mail.gmail.com>
 <571DCA6A.2070803@zend.com>
 <CAFp73XsVJ=1QxvwLbqvDw8o3BD6Ly7BjrP5X+68O=z6iH-brWA@mail.gmail.com>
 <571E35D8.8080504@zend.com> <571E4A83.3080304@garfieldtech.com>
 <571E64A2.2040505@gmail.com>
 <CADqTB_hH4=Rx2ZV_WSJuCPzbnA-ERyFUE8ZsCew2Z6p0+FHWsg@mail.gmail.com>
 <5720A6B4.4000307@lsces.co.uk>
 <CADyq6sKBV0n+xnVhRxsP5RDf0oRLMnNO-BM1VEudRgcK1s199A@mail.gmail.com>
 <CADyq6s+P5p-xdJ8CQaFo3Nrwe7ooyCLg1p=98E0kcSscBbSe8A@mail.gmail.com>
 <CADyq6sJp-krEpGgat7hWm2YpvtfwAfK1ya0as4Tv2qtCSeNgAw@mail.gmail.com>
 <5721B9DD.3050300@lsces.co.uk>
 <ab6c13cd-c756-5fcc-d3ff-8bf9bbd2bdb9@gmail.com>
Message-ID: <35e2d173-ffdc-c70a-9afe-9742618fca14@gmail.com>
Date: Sat, 30 Apr 2016 15:45:59 -0700
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:45.0)
 Gecko/20100101 Thunderbird/45.0
MIME-Version: 1.0
In-Reply-To: <ab6c13cd-c756-5fcc-d3ff-8bf9bbd2bdb9@gmail.com>
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
Subject: Re: [PHP-DEV] PHP Attributes -> docBloc alternatives ...
From: smalyshev@gmail.com (Stanislav Malyshev)

Hi!

> As far as I know, the PHP core has never dictated docblock contents, or
> any other aspect of coding style. Such decisions are up to "the

True, but having common standards which include docblocks in not unheard
of in programming ecosystems.

In Java world, prescribing docblock contents - not by the language, but
by the tools like maven plugins - is a common occurrence in projects. Of
course, as many other things, some Java tools take it a bit overboard
IMHO by doing things like failing build if you forget a dot at the end
of a sentence in a comment, but that's for the tool builders and admins
to decide.

In Python world, there are also common tools that also check docblocks
and alert on docblock contents not fitting standards.

All these outside of core language, of course.
-- 
Stas Malyshev
smalyshev@gmail.com