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
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
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