One very good idea for the PHP manual is creating individual changelogs per function. This changelog would, for example, be used for new and changed parameters, changed behaviors such as default values, and various other changes. This would replace the massive use of <note> clutter in the PHP manual. Changelog entries could also be used in sections, like the session reference could use this. Perhaps reference sections could also list new functions.
I have no specifics and believe Goba has done some preliminary work on this topic but am thinking this should be discussed at the doc meeting. What's the status on this wonderful idea?
I have not done preliminary work on this. This seems to be a very good idea, and would help structure our function documentation better. Joined with the better explanation of parameters. You see we have parameters explained now in free text. I prefer something like the XML functions docs use, like http://php.net/xml_parse for example. All these things are to make the docs a bit more formal, so users can find relevant information quicker.
Goba
-- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
