* Smylers ([EMAIL PROTECTED]) [070621 20:33]: > Documentation, unlike code, doesn't have to be backwards compatible: if > Perl 6.0.1 changes the API of a standard function that will break > existing code; but if Perl 6.0.1 has documentation with a different > structure from Perl 6.0.0, that won't break anything.
When 6.0.1 changes the doc structure, then all 6.0.0 docs are unusuable, or need conversion. Although this doesn't cause code breaking, it does have maintenance and usability issues. Don't forget that Perl code is so compact that we (at least me) have more lines of doc than of code in our files. If you take documentation serious enough, you certainly do want (at least some) backwards compatibility too. And as much as possible automatic consistency checks/warrants. -- MarkOv ------------------------------------------------------------------------ Mark Overmeer MSc MARKOV Solutions [EMAIL PROTECTED] [EMAIL PROTECTED] http://Mark.Overmeer.net http://solutions.overmeer.net