Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:123014
Message-ID: <ef6f3e94-68de-4df3-9fc6-e3c246cc648e@bastelstu.be>
Date: Sun, 7 Apr 2024 16:09:52 +0200
Precedence: bulk
MIME-Version: 1.0
Subject: Re: [PHP-DEV] [RFC] Casing of acronyms in class and method names
To: Juliette Reinders Folmer <php-internals_nospam@adviesenzo.nl>,
 internals@lists.php.net
References: <792b2282-b7a3-40dd-899c-daab55353316@bastelstu.be>
 <69107662-eb03-4b75-8eed-59dd2eed6559@gmail.com>
 <66103C7A.3040906@adviesenzo.nl>
 <80ac7108-e016-4ae8-87ad-50afa0c2f257@bastelstu.be>
 <37f1b0c6-a7c8-41f3-bf2f-7dd466bb31c9@app.fastmail.com>
 <66106DDF.6050308@adviesenzo.nl>
 <2eb57476-1952-44f7-8408-762faa4f5971@bastelstu.be>
 <661222EE.3050303@adviesenzo.nl>
Content-Language: en-US
In-Reply-To: <661222EE.3050303@adviesenzo.nl>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
From: tim@bastelstu.be (=?UTF-8?Q?Tim_D=C3=BCsterhus?=)

Hi

On 4/7/24 06:37, Juliette Reinders Folmer wrote:
> I forwarded your questions from above verbatim to Nicolas and this was
> his response (also quoted verbatim):

Thank you.

>   > So, this one is interesting.
>   > Sure, if you look at these extremes, stringing them back to back all
> in a uppercase, they are not particularly user-friendly to read.
>   > Then again, none of these solutions are super user-friendly. We are
> dealing with making the best of things.
>   > I have to say, it always gets my goat a little bit when people raise
> “the extremes” in the context of accessibility. Somehow it always ends
> up feeling like, to me at least, like a copout.
>   > Like, sure if you have someone who is blind, deaf, and paralyzed from
> a stroke, making something accessible to them is going to be extremely
> difficult. It doesn’t mean you shouldn’t make things accessible to
> people who are blind, to people who are deaf, and to people who are
> paralyzed from a stroke.
>   > This is a little bit like that. The solution I proposed earlier may
> not work for everybody. But it will work for a majority.

While I've called the examples “extreme” myself, I don't believe they 
are *uncommon*. Programming is full of various acronyms and it naturally 
follows that some identifiers will consist of consecutive acronyms or 
abbreviations. I've mentioned five of them in my previous email, but 
added some more to the RFC as part of Saki's namespace question (SSL + 
CRL + URL).

Here are some more acronyms that are reasonable to appear within in a 
single identifier. Some of them might make sense to put in a namespace 
hierarchy which comes with the backslash as a separator, but this does 
not work for method names:

ASN.1 + DER
AES + GCM
JWT + RSA
HMAC + SHA-256
API + Anything probably
SAML + SSO
GPU + CUDA
ARM + CPU

Apologize the focus on cryptographic concepts, but these case to my mind 
most easily :-)

Best regards
Tim Düsterhus