Everything

php

INSTALL and win32/install.txt files

php.internals

Kalle Sommer Nielsen

9 years ago

Howdy

I did a recent commit with some internal cleanup and I noticed both of
these files are largely outdated, is there any objects of replacing
their contents with a link to our docs at php.net instead?

Side note, far from all doc people have karma for these two files, and
they are largely uncharged from the days of PHP4.

--
regards,

Kalle Sommer Nielsen
kalle@php.net

Sara Golemon

9 years ago

On Wed, Jul 19, 2017 at 3:12 AM, Kalle Sommer Nielsen <kalle@php.net> wrote:

> I did a recent commit with some internal cleanup and I noticed both of
> these files are largely outdated, is there any objects of replacing
> their contents with a link to our docs at php.net instead?
>

There's some (admittedly limited) benefit to having such instructions
in tree.  Is there any way this can be auto-generated from docbook
sources?  We could easily add it to the release process.

Though I'm not super-bothered personally if you want to just make it a
link.  The idea of installing internet software without an internet
connection is a bit weird.

> Side note, far from all doc people have karma for these two files, and
> they are largely uncharged from the days of PHP4.
>

That's fixable, though should be addressed on an individual basis.  We
have "doc" people who have @php.net accounts and have never pushed a
diff in their lives.  I'm sure someone with AVAIL karma can see to
their needs if they request php-src/doc karma.

-Sara

Kalle Sommer Nielsen

9 years ago

Hi Sara

2017-07-19 15:34 GMT+02:00 Sara Golemon <pollita@php.net>:

> There's some (admittedly limited) benefit to having such instructions
> in tree.  Is there any way this can be auto-generated from docbook
> sources?  We could easily add it to the release process.

I think it would be fairly easy, for me personally its been too long
since I worked with PhD to make a renderer to generate just that

> Though I'm not super-bothered personally if you want to just make it a
> link.  The idea of installing internet software without an internet
> connection is a bit weird.

I totally agree, it is a bit weird for those cases without internet
access, but I think we can assume that 99.9% of everyone using PHP has
access to the internet one way or another. If I remember correctly
then back some almost 10 years ago we had a similar talk but it was
the same concern that not everyone had internet access and it would
generally be a "nice thing" to have, I do agree with the latter of
that statement.

> That's fixable, though should be addressed on an individual basis.  We
> have "doc" people who have @php.net accounts and have never pushed a
> diff in their lives.  I'm sure someone with AVAIL karma can see to
> their needs if they request php-src/doc karma.

True, but barely anyone cared to do anything about it, and tho I don't
think the karma is the problem. The only people that updates them is
the ones that grep and find a hit. Having to maintain the same
resource in 3 places is odd too, INSTALL, win32/install.txt,
phpdoc/en/install/?

TL;DR if no one really objects, I will turn these into links over the
course of the weekend

--
regards,

Kalle Sommer Nielsen
kalle@php.net