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

There is also the related <https://bugs.php.net/80415>.

On 19.04.2021 at 12:39, Christoph M. Becker wrote:

> 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]
>>>
>>