I would really really really really appreciate if the [DOC] tag was used more.
While only random new features (or whatever requiring docs) are tagged with [DOC] it is totally useless as the doc team still has to browse through every single commit to figure out if there is something in it to document. To make matters worse; some new optional parameters/functions/whatever are disguised as bug reports with absurd summary and when they get fixed only "Fixed bug#xxx (foobar)" is added to the commit message and NEWS file... you really expect the doc team to actually _read_ the _commit_ and ignoring the commit message? Undocumented features are useless to the "general public". And no, your blog and/or article on/in devzone/php|arch is definitely not the place to write documentations if you want the feature to be used. On a related note: When reclassifying bug reports as "documentation problem" *please* mention what exactly it is that needs to be documented! Common guys, we can do a lot better here. -Hannes On Feb 12, 2008 10:27 AM, Dmitry Stogov <[EMAIL PROTECTED]> wrote: > dmitry Tue Feb 12 09:27:46 2008 UTC > > Added files: (Branch: PHP_5_3) > /ZendEngine2/tests heredoc_001.phpt heredoc_002.phpt > heredoc_003.phpt heredoc_004.phpt > heredoc_005.phpt heredoc_006.phpt > heredoc_007.phpt heredoc_008.phpt > heredoc_009.phpt heredoc_010.phpt > heredoc_011.phpt nowdoc.inc nowdoc_001.phpt > nowdoc_002.phpt nowdoc_003.phpt nowdoc_004.phpt > nowdoc_005.phpt nowdoc_006.phpt nowdoc_007.phpt > nowdoc_008.phpt nowdoc_009.phpt nowdoc_010.phpt > nowdoc_011.phpt nowdoc_012.phpt nowdoc_013.phpt > nowdoc_014.phpt nowdoc_015.phpt > > Modified files: > /php-src NEWS > /ZendEngine2 zend_compile.c zend_highlight.c zend_language_parser.y > zend_language_scanner.l > Log: > Added NEWDOC > > > -- > Zend Engine CVS Mailing List (http://cvs.php.net/) > To unsubscribe, visit: http://www.php.net/unsub.php > -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
