Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:121380
MIME-Version: 1.0
References: <CAJpLVh1P0kTneo+chFEdp2oCmSKNpgpDxSXd3atv9OHKejABgw@mail.gmail.com>
 <9d5388fa-a5a5-4fa5-81ff-16f6670f80b6@gmail.com> <CABigaAULVVGhZCD7bvthZ1NsVc1s8LDsnTS-9=V=APGx=tjbfw@mail.gmail.com>
 <ca0e12bd-daba-4e25-b066-4ffc4b097689@processus.org>
In-Reply-To: <ca0e12bd-daba-4e25-b066-4ffc4b097689@processus.org>
Reply-To: autaut03@gmail.com
Date: Wed, 18 Oct 2023 14:53:57 +0300
Message-ID: <CABigaAW0nRt9So1tZC0hLj6Di2FEUFCiyAGimjGR3E41xVvEKg@mail.gmail.com>
To: Pierre <pierre-php@processus.org>
Cc: Rowan Tommins <rowan.collins@gmail.com>, internals@lists.php.net
Content-Type: multipart/alternative; boundary="000000000000003a170607fc4cf2"
Subject: Re: [PHP-DEV] Previous discussions about generics syntax only?
From: autaut03@gmail.com (Alex Wells)

--000000000000003a170607fc4cf2
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Wed, Oct 18, 2023 at 2:37=E2=80=AFPM Pierre <pierre-php@processus.org> w=
rote:

> Le 18/10/2023 =C3=A0 13:01, Alex Wells a =C3=A9crit :
> >   The community has just now decided on the PHPDoc syntax for generics,
> has
> > just started widely adopting them in packages and has just got
> first-party
> > support from PHPStorm. I doubt that migrating to yet another temporary
> > solution (one that still doesn't address all of the concerns) is a good
> > idea right now.
>
> Documentation is not code, and you could have syntax errors within
> without ever knowing it. Documentation is documentation and static
> analysis based upon documentation is fragile. All static analyzers may
> not even be in phase, when you contribute to projects you have to learn
> code style and conventions, but you also have to learn documenting style
> and conventions, and you must add the fact that from one project to
> another, generics documentation convention changes. Even thought you
> think it's "community decided convention", not all tools are in sync,
> sadly, and not all the community is OK with it.
>

Agreed with everything. PHPDoc is and will always be a temporary solution,
there's no denying, and I'd much prefer a better solution from the PHP
itself - one's easier to use and parse. All I'm saying is that I don't
believe it's feasible to implement another temporary solution that doesn't
have too many benefits over what the community already has, especially
given PHP's very limited resources. That's why I'm advocating for either
fully type erased generics (with proper, somewhat stable syntax for years
to come) or nothing at all.

--000000000000003a170607fc4cf2--