Newsgroups: php.doc,php.internals
Path: news.php.net
Xref: news.php.net php.doc:969379469 php.internals:40853
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: unknown (pb1.pair.com: domain php.net does not designate 192.18.6.24 as permitted sender)
Date: Fri, 03 Oct 2008 19:02:00 +0200
In-reply-to: <48E3CA24.6060805@chiaraquartet.net>
Sender: Johannes.Schlueter@Sun.COM
To: Greg Beaver <greg@chiaraquartet.net>
Cc: Elizabeth M Smith <auroraeosrose@gmail.com>, phpdoc@lists.php.net,
        internals@lists.php.net
Message-ID: <1223053320.17644.4.camel@goldfinger.johannes.nop>
MIME-version: 1.0
Content-type: text/plain
Content-transfer-encoding: 7BIT
References: <7f3ed2c30810010639q445b94b3m637ed929215d1cc6@mail.gmail.com>
 <c0e7fa7f0810010707r724c089dv61bde6763b34898@mail.gmail.com>
 <49.5C.04812.F70B3E84@pb1.pair.com> <48E3CA24.6060805@chiaraquartet.net>
Subject: Re: [PHP-DEV] Re: [PHP-DOC] [DOC] Commit messages dead?
From: johannes@php.net (Johannes =?ISO-8859-1?Q?Schl=FCter?=)

On Wed, 2008-10-01 at 14:06 -0500, Greg Beaver wrote:
> I agree with Liz's appraisal of setting up docs for documenting.  This
> could actually be solved with a minimal VMWare appliance that is
> pre-setup with everything we need to do the docs (not sure how hard that
> is to do).  VMware works great on windows and the version we would need
> is free.

As Hannes said: All you need is PHP, PhD and a docbook checkout. The
later one will be outdated anyways when fetching the VMWare-Image and I
assume it's harder to learn how to use the VMWare image than installing
these thing, never did that on Windows, but on my *nix it's a shot task
to get it running.

The hard part is not installation of tools but writing the docs
themselves.

johannes