Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:116118
Message-ID: <7BEE0406-3CAE-4E83-A196-F9F608BE8D17@newclarity.net>
Content-Type: multipart/alternative;
	boundary="Apple-Mail=_FE1877EE-B0C5-4DB1-84C1-763DB4E93341"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.7\))
Date: Tue, 21 Sep 2021 15:28:05 -0400
In-Reply-To: <CAEZPtU62gfKb-xODqm_yk-BE_ycLshuD2_ps733_ReFgksLqaQ@mail.gmail.com>
Cc: PHP internals <internals@lists.php.net>
To: Pierre Joye <pierre.php@gmail.com>
References: <DM6PR07MB66185E23B803C5E5BF858B30F9DF9@DM6PR07MB6618.namprd07.prod.outlook.com>
 <A59125BE-AF91-44D1-9B47-82046B51EE8F@newclarity.net>
 <CAEZPtU7+hgcHwRfaa7-CR9SVv2=HfH46kDVu0pDYm5M=WeFPVg@mail.gmail.com>
 <67BFE5C6-3C3F-4309-97A2-14CA0D8C3B3B@newclarity.net>
 <CAEZPtU62gfKb-xODqm_yk-BE_ycLshuD2_ps733_ReFgksLqaQ@mail.gmail.com>
Subject: Re: [PHP-DEV] Adding `final class Deque` to PHP
From: mike@newclarity.net (Mike Schinkel)

--Apple-Mail=_FE1877EE-B0C5-4DB1-84C1-763DB4E93341
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
	charset=us-ascii

> On Sep 21, 2021, at 1:12 PM, Pierre Joye <pierre.php@gmail.com> wrote:
> On Tue, Sep 21, 2021, 11:56 PM Mike Schinkel <mike@newclarity.net =
<mailto:mike@newclarity.net>> wrote:
> > On Sep 21, 2021, at 3:45 AM, Pierre Joye <pierre.php@gmail.com =
<mailto:pierre.php@gmail.com>> wrote:
> >=20
> > On Tue, Sep 21, 2021 at 11:21 AM Mike Schinkel <mike@newclarity.net =
<mailto:mike@newclarity.net>> wrote:
> >=20
> >> Honestly, at first I confused `Deque` with `Dequeue` and was =
wondering why we would name a class with a verb?  It wasn't until =
Rowan's comment that I realized `Deque` is an abbreviation.
> >>=20
> >> Which begs the question: how many other PHP developers will know =
computer science terms like this well enough to know `Deque` is a noun =
when they see it, and more importantly how many PHP developers will =
think to search for `Deque` when they need a queue?
> >=20
> > Unlike the Vector name which is really confusing as it is not a
> > vector, Deque is actually relatively known for anyone needing a =
double
> > ended queue. It even comes first in google search, wikipedia or java
> > implementations, which matches this implementation.
>=20
> Being able to google what Deque means is one thing, but thinking to =
search for it when you don't know it exists *and* you don't know that =
Deque is the term you would need to be searching for.
>=20
> > We expect our
> > users to know all weird names of different patterns, I trust them to
> > be able to learn what a Deque is. :)
>=20
> So we expect PHP developers to have a computer science background? =
Maybe you are assuming everyone minimally has your expertise?  Have we =
as a group decided to forsake beginners?=20
>=20
>=20
> It is not what I was trying to explain.
>=20
> However if one looks at the php documentation looking for specific =
things like these, the Deque will be there.=20
>=20
> So I am not expecting anyone to have a CS background (btw, I don't), =
however I do have a minimal trust in users reading the docs and doing a =
minimum of research.=20

And what I was trying to explain is that given my past experience =
working with other PHP developers, I believe that trust is misplaced for =
many. =20

And why make it harder than it needs to be? For PHP, jargon is Bad(tm), =
IMHO anyway.

-Mike


--Apple-Mail=_FE1877EE-B0C5-4DB1-84C1-763DB4E93341--