Re: On removing PHP 5 docs (yes, I saw the previous thread)
Tiffany Taylor <[email protected]>
| Newsgroups | gmane.comp.php.documentation.general |
|---|---|
| Message-ID | <CAHSBg44C55=kmYxghUvJvqVPk=snRS2OWVmpsmVqL+bVYfDdAQ@mail.gmail.com> |
Hey Sobak, Hopefully quick question, I was reviewing your changes, I noticed that yac[1] and rpminfo[2] were removed from the reference[3] book. Was this intentional? It appears they are current PECL extensions which support PHP 7+ - https://pecl.php.net/package/yac, https://pecl.php.net/package/rpminfo. I'm wondering the reason why so I know whether to fix my local build, because I get errors that their entities are missing from the manual.xml file when I attempt configuration. Thanks! Tiffany [1] https://github.com/Sobak/doc-en/search?q=yac&type=code [2] https://github.com/Sobak/doc-en/search?q=rpminfo&type=code [3] https://github.com/Sobak/doc-en/tree/master/reference On Wed, Sep 2, 2020 at 6:43 AM Christoph M. Becker <[email protected]> wrote: > On 24.07.2020 at 15:02, Christoph M. Becker wrote: > > > On 20.04.2020 at 07:40, Maciej Sobaczewski wrote: > > > >> W dniu 19.04.2020 o 16:38, Christoph M. Becker pisze: > >>> > >>> On 19.04.2020 at 07:56, Maciej Sobaczewski wrote: > >>> > >>>> I just noticed the question about removing PHP 5 docs and I was very > >>>> pleasantly surprised by Peter's and others approach to do so in a > year.. > >>>> > >>>> I'll just chim in and say that I had something similar on my mind and > >>>> one night when I was struggling from insomnia I already did a rather > >>>> significant portion of the removals on my fork's branch > >>>> > >>>> > https://github.com/php/doc-en/compare/master...Sobak:experiment/remove-php5 > >>>> > >>>> > >>>> Then I thought that you guys are never ever going to accept that so > >>>> quickly and stopped but a really big part is already done. Soo... > >>>> you know, just ping me when the time will come :) I have some > >>>> experience from back then when I was removing PHP 4 bits so I > >>>> believe that I should be able to finish it in a reasonable time. > >>>> > >>>> I only want to believe that I'm right and rebasing it on top of > >>>> year's changes will not be _that_ hard :) > >>> > >>> Thanks for having already worked on this! Maybe it's worthwhile to > >>> provide a pull request, and mark it with the PHP 8.0 label (or > similar)? > >> > >> I surely will, so that it doesn't disappear or get easily forgotten. > >> However, I would like to work on that a bit longer before opening > >> the PR, esp. now that I see there's a will and need for something > >> like that. > >> > >> I'm kind of git-pedant so I'd like to keep it clean and somehow > >> possible to review despite its gargantuic size (thus the commit > >> separation). > >> > >> I will work on that in the next week or two, probably doing a bit > >> more yet still not everything (my minimal plan is to finish the > >> changelogs and start removing inline mentions, we'll see how far > >> I can get with this). > >> > >> One request, though. Please let me know before this PR would be > >> merged. If I will not be responding in two or three days then sure, > >> go with it, it's open source after all :) But I would really appreciate > >> abbility to have a final glance and possibly improve some things before > >> this goes live. > > > > Some of the devs and doc people had just a discussion about starting to > > document PHP 8.0 as soon as possible, and I think it would be good to > > remove the PHP 5 specific documentation before adding PHP 8 specifics. > > > > Would you be still willing (and have the time) to proceed with the PHP 5 > > docs removal? > > Well, I think we should proceed with the PHP 5 doc removal within the > next days. If nobody beats me to it, I'll have a stab at it on the > weekend. > > Cheers, > Christoph >