Re: Maintaining PHP 5 documentation

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