Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:112063
MIME-Version: 1.0
References: <CADZ9LSXePBHB6A5xEFGvW9MZ7pOpM0Hht10cjSkBXQnQGSP8dQ@mail.gmail.com>
In-Reply-To: <CADZ9LSXePBHB6A5xEFGvW9MZ7pOpM0Hht10cjSkBXQnQGSP8dQ@mail.gmail.com>
Date: Thu, 15 Oct 2020 18:32:37 +0300
Message-ID: <CAJW__o3kd22CxkWyePZufCF0g4dyTRyA8=Sspsfhun90FL=mFw@mail.gmail.com>
To: Roman Pronskiy <roman.pronskiy@jetbrains.com>
Cc: Internals <internals@lists.php.net>
Content-Type: text/plain; charset="UTF-8"
Subject: Re: [PHP-DEV] PHP 8 release announcement page on php.net
From: kalle@php.net (Kalle Sommer Nielsen)

Hi

Den man. 12. okt. 2020 kl. 10.57 skrev Roman Pronskiy
<roman.pronskiy@jetbrains.com>:
> https://i.imgur.com/6fKmTyM.jpg

The concept looks great, however in the current state, it cannot go in
like that which mainly comes down to neutrality.

- This means we cannot display projects such as Symfony, Laravel and
WordPress at the top.Sure they are popular, but we cannot promote
them.
- At the same time we cannot have the community leaders section and
potentially not the one beneath that, again this comes down to
neutrality and not to show any sort of favoritism. Note we do not link
to Core Developer blogs or anything like that, the closet you would
get to that is people.php.net, and even that is limited.

This basically means that at best, this page can be a glorified
migration page with code examples and new features presented in a long
page style layout (unlike the sectioned multi page style that the
manual traditionally has), which I would be perfectly fine with and
accept if posted as a PR for php-web on Github. Personal side note
here: I would prefer to keep the written language similar to existing
style on PHP.net for consistency, the "overselling" part is personally
a bit too much for me, and more something I would expect to read on
pages like Zend.com that has a business gain for getting users on PHP8
or whatnot, however not a deal-breaker for me.

However the most important thing I see here is to actually begin
documenting these features, as linking to their RFCs, is not the way
we should document features. I'm currently not aware of what the
status is on that, but given the last few versions of PHP, we are
probably far from a state where PHP8 is broadly available in the
manual. This naturally is not a blocker for this project, but a
consideration.


Also note that anything related to the websites belong to the
php-webmaster@ mailing list, *not* internals and I would highly
recommend moving the thread there.


-- 
regards,

Kalle Sommer Nielsen
kalle@php.net