Re: Maintaining PHP 5 documentation

From: Date: Wed, 09 Dec 2020 18:21:00 +0000
Subject: Re: Maintaining PHP 5 documentation
References: 1 2 3 4 5 6 7 8 9 10 11 12  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969387709@lists.php.net to get a copy of this message
On Wed, 9 Dec 2020 at 15:57, Anna Filina <me@afilina.com> 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 <me@afilina.com> 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 <giovanni@giacobbi.net> >> wrote: >> >>> On Tue, 8 Dec 2020 at 18:44, Anna Filina <me@afilina.com> 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

« previous php.doc (#969387709) next »