Re: Cool URIs don't change - what should we do when removing andrenaming pages?

On 18.04.2021 at 16:59, Anna Filina wrote:

> I already addressed this problem months ago with this PR:
> https://github.com/php/web-php/pull/385.
>
> Unfortunately, the nginx is misconfigured and gives hard 404s instead of
> the page that you see in the PR's screenshot. I offered my help with this
> second issue months ago, but it was dismissed. I'm extending my offer once
> more: please allow me to take a look at and fix the nginx configuration.

I can confirm that /manual/en/soapclient.soapclient.php works locally as
desired, but <http://php.net/manual/en/soapclient.soapclient.php> does
not.  Could any of the system folks please have a look, or give Anna
access to the server?

Thank you in advance,
Christoph

> On Sun, Apr 18, 2021 at 9:57 AM Rowan Tommins <[email protected]>
> wrote:
>
>> Hi,
>>
>> With the removal of PHP 5 information from the manual (which I approve
>> of, by the way) a lot of pages have been, or will soon be, either
>> removed or renamed. Unfortunately, this leads to two problems:
>>
>> * The URLs give a 404 page (and a really ugly 404 at that), even when
>> there is a useful page we could direct readers to.
>> * User notes on the deleted pages are orphaned.
>>
>> I noticed this because #2 in the list of "pages with the most notes" is
>> currently this non-existent page:
>> https://www.php.net/manual/en/soapclient.soapclient.php
>>
>> Until a few months ago, that was the manual page for the SoapClient
>> class's constructor, but since PHP 8.0 removed "PHP 4-style"
>> constructors, it is now at
>> https://www.php.net/manual/en/soapclient.construct.php (which was
>> previously a "this is an alias for..." stub).
>>
>>
>> A simple solution is to have "soft redirects" similar to how aliases are
>> documented - stub pages containing only a single language snippet, and
>> possibly a "See also" section. I think we would need:
>>
>> * "This function no longer exists in maintained versions of PHP."
>> * "This method no longer exists in maintained versions of PHP."
>> * "This function has been renamed to"
>> * "This method has been renamed to"
>> * "This page has been moved to"
>>
>> This would hopefully be easy for translators to maintain, because they
>> could just adjust the snippets centrally, and mark all the stubs as
>> fully translated.
>>
>> There's no way I can see to batch move notes, but maybe moving them one
>> by one and deleting some as we go is the way to go there anyway.
>>
>> What do you think?
>>
>> Regards,
>>
>> --
>> Rowan Tommins
>> [IMSoP]
>>
>