Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:125694
Feedback-ID: ia2404087:Fastmail
Precedence: bulk
MIME-Version: 1.0
Date: Thu, 26 Sep 2024 13:58:44 -0700
To: =?UTF-8?Q?Tim_D=C3=BCsterhus?= <tim@bastelstu.be>
Cc: internals@lists.php.net
Message-ID: <325a5a48-2a65-4225-8c11-db2409d4f841@app.fastmail.com>
In-Reply-To: <477c134b8fbb2254de2151b747274064@bastelstu.be>
References: <642cb3ea-bf51-4832-8539-0540742000e1@app.fastmail.com>
 <cdd6db55-37cd-4c19-97d5-e6cfca8c812b@app.fastmail.com>
 <477c134b8fbb2254de2151b747274064@bastelstu.be>
Subject: Re: [PHP-DEV] [RFC] [Discussion] Using and Mentioning Third-party Packages in
 PHP Documentation and Web Projects
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
From: jimw@trainedmonkey.com ("Jim Winstead")

On Thu, Sep 26, 2024, at 5:13 AM, Tim D=C3=BCsterhus wrote:
> Hi
>
> Am 2024-09-25 01:45, schrieb Jim Winstead:
>> It has taken me longer than initially anticipated to circle back to=20
>> this, but I intend to open the voting on this RFC on Thursday=20
>> (2024-09-26T16:00:00Z or so) unless there are any other changes that=20
>> anyone would like to propose.
>>=20
>> The RFC again: https://wiki.php.net/rfc/web-and-doc-use-not-endorseme=
nt
>
> Thank you. I've used your reminder as the opportunity to catch up with=20
> this thread after my vacation.
>
> I'm likely going to vote =E2=80=9Cno=E2=80=9D on your RFC, because I d=
o not believe that=20
> your proposed statement of principle makes the situation any *less*=20
> vague. It just makes the situation vague in a different way, because=20
> there are no guidelines regarding what is acceptable and what is not, =
as=20
> also mentioned by others in this RFC's discussion thread.

I am very open to discussing guidelines that anyone thinks would be more=
 acceptable than my proposal.

 I think the closest anyone has come to another suggestion so far is Lar=
ry's proposal that individual deviations from the currently-unspecified =
policy should be settled by an RFC. (https://news-web.php.net/php.intern=
als/125284)

The currently unstated guideline is "don't mention third-party tools" an=
d it has been very inconsistently enforced so we have things like https:=
//www.php.net/manual/en/install.windows.tools.php and https://www.php.ne=
t/manual/en/install.macosx.packages.php.

We have 250 pages of documentation for a UI extension that hasn't seen a=
ny movement in eight years (https://www.php.net/manual/en/book.ui.php), =
but the documentation can't mention Composer because it's the wrong sort=
 of contribution to the PHP ecosystem.

Jim