Re: 5.4 beta
| From: | Daniel Convissor | Date: | Fri, 07 Oct 2011 19:27:05 +0000 |
| Subject: | Re: 5.4 beta | ||
| References: | 1 2 3 4 5 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-55738@lists.php.net to get a copy of this message | ||
On Fri, Oct 07, 2011 at 08:13:49PM +0200, Hannes Magnusson wrote:
>
> When 5.3 came around, I literally had to diff the sources to figure
> out what was going on, I am not going through that again.
...
> If that doesn't happen, we wind up with more features like streams and
> filters which took 5+ years to document.
The person making changes to the language needs to ensure those changes
are documented. That can include either writing a first draft of the
docs themselves and/or teaming up with someone on the documentation
team. The most reliable thing to do is commit the php-src and phpdoc
changes in one commit.
At the very least, we could have a TODO file in phpdoc that contains
a simple plain text explanation of the new functionality.
"You can say that I'm a dreamer...",
--Dan
--
T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y
data intensive web and database programming
http://www.AnalysisAndSolutions.com/
4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409