Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:44388
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain googlemail.com designates 209.85.220.220 as permitted sender)
DomainKey-Status: bad
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=googlemail.com; s=gamma;
        h=message-id:date:from:user-agent:mime-version:to:subject:references
         :in-reply-to:content-type:content-transfer-encoding;
        b=c+4/2aG1q/zL1lpqhx9mDihl2G+tOp8kkOdcNMFuLqKH/UCNYUvpW3kCdlG5uaCBDh
         6Eu4sHXqY2CEIZgdyl4nFzZtEgvKJVdV5agUEQ7WsiP5O1YZjoFDBuSR6eG6py1xsVkq
         fDO5RzS5yo/zgd2wCyARJ+KdwYK8RMT5+nYNo=
Message-ID: <4A3E0A1B.3080305@googlemail.com>
Date: Sun, 21 Jun 2009 11:23:23 +0100
User-Agent: Thunderbird 2.0.0.21 (X11/20090318)
MIME-Version: 1.0
To: PHP Developers Mailing List <internals@lists.php.net>
References: <4A3BBF03.5050207@lerdorf.com>
In-Reply-To: <4A3BBF03.5050207@lerdorf.com>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Subject: Re: [PHP-DEV] Call for a doc push
From: zoe.slattery@googlemail.com (zoe)

Hi
> Guys and gals, in the old days we had a very close tie between the code
> and the documentation.  As the project has grown the two have drifted
> apart.  I think this is mostly because the phpdoc team has done an
> amazing job keeping up with the code changes and writing awesome
> documentation.  This has made us a bit lazy and complacent.
>
> I would like to encourage everyone on this list to spend a little bit of
> time looking at the parts of the documentation that cover things you are
> familiar with.  Or even just going through some of the doc bugs and
> helping out in general.
>   
This reminded me that a while ago I made some opcode documentation 
available in the form of a set of charts written by Andy Wharmby 
(http://www.zapt.info/PHPOpcodes_Sep2008.odp) and some opcode samples 
(http://www.zapt.info/opcodes.html) from the IBM Japan team. I don't 
think either of these ever made it the PHP docs and as they are  still 
on my personal website and they are somewhat at risk :-/ 

I heard recently that people were using them 
(http://tr.im/phpcompilerinternals) so I'd like to put them somewhere 
more permanent. My current plan is to move them both to sp1.php.net. 
Does anyone object? Or better still would anyone be willing to integrate 
them with the PHP docs?

Zoe