Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:99933
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.214.54 as permitted sender)
MIME-Version: 1.0
Sender: kalle.php@gmail.com
In-Reply-To: <CAESVnVpwSGh-r=Fje7dUUWUZnE++nXcMzvdFoVq_3sADSF=mMA@mail.gmail.com>
References: <CAJW__o1SOUbRupyYyuiR=QfydYqTxKgOx1bdg7ar9jZO8EHkGA@mail.gmail.com>
 <CAESVnVpwSGh-r=Fje7dUUWUZnE++nXcMzvdFoVq_3sADSF=mMA@mail.gmail.com>
Date: Wed, 19 Jul 2017 15:48:36 +0200
Message-ID: <CAJW__o1=0MJJK9SHc7as5gRO=QyxNY_Xz8uBgdqMWyZJM3CJyw@mail.gmail.com>
To: Sara Golemon <pollita@php.net>
Cc: Internals <internals@lists.php.net>
Content-Type: text/plain; charset="UTF-8"
Subject: Re: [PHP-DEV] INSTALL and win32/install.txt files
From: kalle@php.net (Kalle Sommer Nielsen)

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