Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:99931
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: softfail (pb1.pair.com: domain golemon.com does not designate 209.85.128.177 as permitted sender)
MIME-Version: 1.0
Sender: php@golemon.com
In-Reply-To: <CAJW__o1SOUbRupyYyuiR=QfydYqTxKgOx1bdg7ar9jZO8EHkGA@mail.gmail.com>
References: <CAJW__o1SOUbRupyYyuiR=QfydYqTxKgOx1bdg7ar9jZO8EHkGA@mail.gmail.com>
Date: Wed, 19 Jul 2017 09:34:16 -0400
Message-ID: <CAESVnVpwSGh-r=Fje7dUUWUZnE++nXcMzvdFoVq_3sADSF=mMA@mail.gmail.com>
To: Kalle Sommer Nielsen <kalle@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: pollita@php.net (Sara Golemon)

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