Re: Maintaining PHP 5 documentation

Hi team,

I made the necessary changes to the php.net code to suggest legacy manuals
in case of a 404. PR with screenshot for your perusal and comments:
https://github.com/php/web-php/pull/385.

Cheers!
Anna

On Wed, Dec 9, 2020 at 2:57 PM Anna Filina <[email protected]> wrote:

> Thanks George,
>
> I checked out the web-php repo, ran it locally and am now working on
> handling retired manual pages. I'll post a PR with my solution and we can
> decide on the details there. I'll try to incorporate as much of your
> feedback from this thread.
>
> Thank you all very much for being so open and helpful!
>
> Anna
>
> On Wed, Dec 9, 2020 at 1:21 PM G. P. B. <[email protected]> wrote:
>
>> On Wed, 9 Dec 2020 at 15:57, Anna Filina <[email protected]> wrote:
>>
>>> I added the readme, information about contributing and code of conduct:
>>> https://github.com/zendtech/php-legacy-docs
>>>
>>> I also have a draft of the license:
>>> https://github.com/zendtech/php-legacy-docs/pull/4/files
>>> I have no idea how to write licenses. Is the attribution good enough?
>>> Let me know what I can improve.
>>>
>>> Also, anything I can do to help with redirecting retired pages to legacy
>>> docs? I can write an nginx config, a code snippet to verify availability of
>>> legacy counterpart, etc. I booked my week for this.
>>>
>>> Anna
>>>
>>> On Tue, Dec 8, 2020 at 2:58 PM Anna Filina <[email protected]> wrote:
>>>
>>>> Giovanni,
>>>>
>>>> I used the HTML files that were made available by the documentation
>>>> team on http://doc.php.net/archives/
>>>> These files had a slightly different layout, included no fonts and had
>>>> no notes. I'm open to suggestions if there's a way to grab these resources
>>>> and merge them into the HTML files.
>>>>
>>>> The notes shouldn't be part of the HTML archive on GitHub though, as I
>>>> wouldn't want them to be edited by contributors in the long run.
>>>>
>>>> Anna
>>>>
>>>> On Tue, Dec 8, 2020 at 2:03 PM Giovanni Giacobbi <[email protected]>
>>>> wrote:
>>>>
>>>>> On Tue, 8 Dec 2020 at 18:44, Anna Filina <[email protected]> wrote:
>>>>>
>>>>>> Hi team,
>>>>>>
>>>>>> Zend has agreed to both host the legacy docs and dedicate time to
>>>>>> maintaining them. I already put together a site that displays the archives.
>>>>>>
>>>>>> The docs are available here: https://php-legacy-docs.zend.com/
>>>>>> The archives are on GitHub:
>>>>>> https://github.com/zendtech/php-legacy-docs (still needs readme,
>>>>>> license and all the gory details).
>>>>>> I fixed the style tags in the archives' HTML, so that contributors
>>>>>> can preview their changes locally with css.
>>>>>>
>>>>>>
>>>>> Any chance to have it actually as it is now on https://docs.php.net/
>>>>> including the comments the font and the layout? Like a full snapshot of the
>>>>> state previous to PHP5 eviction, I found the notes sometimes very useful.
>>>>>
>>>>>
>> I'm far from an expert on how we handle web stuff for the PHP project,
>> but maybe a good place to start is php/web-php (
>> https://github.com/php/web-php)
>>
>> And CSS/JS should be located at https://github.com/php/web-shared from
>> my understanding.
>>
>> George P. Banyard
>>
>