On Jan 23, 2010, at 11:40 AM, Hannes Magnusson wrote: > On Sat, Jan 23, 2010 at 19:34, Philip Olson <phi...@roshambo.org> wrote: >> > [..] >> Summary: Only changing the writing style would be simplest, and would still >> increase readability of the PHP manual. > > What about changelog entries? > Should those still say "parameter abc became available in PHP5.0.0" > for functions that have improved since php4?
In this scenario the changelogs would remain as is, because changelog entries should separate the PHP version from the description. Having an entry for 5.0.0 is fine because this is how changelogs read. However, having text embedded within the manual like "As of PHP 5, X behaves like Y" is a different story that affects overall readability. It should simply say "X behaves like Y". And in theory our migration guides already state this stuff, but it's something we should be sure of. Regards, Philip
