Re: On removing PHP 5 docs (yes, I saw the previous thread)
| From: | Tiffany Taylor | Date: | Sat, 19 Sep 2020 16:16:53 +0000 |
| Subject: | Re: On removing PHP 5 docs (yes, I saw the previous thread) | ||
| References: | 1 2 3 4 5 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969387619@lists.php.net to get a copy of this message | ||
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 <cmbecker69@gmx.de>
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-php53º¤Úá̼¡5
> È_)~
> >>>>
> >>>>
> >>>> 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
>