Re: Contractions in the English PHP Documentation and supporting scripts/files.

On Wed, 5 Jul 2006, Jason Gilmore wrote: > I'm a book editor (Apress), and this subject often comes up. While many > technical writing style guides shun the use of contractions, I think the > perception of being too informal or confusing to non-native English > speakers is rather outdated, and believe contractions improve > readability because the lack thereof results in a somewhat robotic flow. I think Jason must be reading Kathy's blog. :) http://headrush.typepad.com/creating_passionate_users/2005/01/your_users_brai.html Given that Kathy has written or edited three of Amazon's Top 15 best selling computer programming books (even better if you filter out once aimed at non-programmers), I think she's probably worth listening to. -adam -- adam@trachtenberg.com | http://www.trachtenberg.com author of o'reilly's "upgrading to php 5" and "php cookbook" avoid the holiday rush, buy your copies today!