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
--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
