News Feed
Sections




News Archive
Looking for more information on how to do PHP the right way? Check out PHP: The Right Way

Johannes Schluter's Blog:
Code and human languages
August 06, 2009 @ 11:34:21

In a recent blog post from Johannes Schluter he proposes a "universal language" for documentation and code comments - English.

The argument for using only English is simple: Every developer should know at least basic English and using English helps when either outsourcing, opensourcing or reaching new markets. Now there are arguments against English, too, one is that not all developers are able of using English properly so reading and writing comments is more difficult for them - now you don't have to write long prosaic texts in comments, but still...

Comments on the post vary - some disagree and some say that this is how they're already doing things and it seems to be working out well.

0 comments voice your opinion now!
code comment documentation language


blog comments powered by Disqus

Similar Posts

PHPMaster.com: Practical Code Refactoring, Part 2 - Readability

NetTuts.com: Refactoring Legacy Code: Part 3 - Complex Conditionals

Alan Knowles\' Blog: Parsing PHP in D.

Chris Hartjes' Blog: What Is Really Considered Documentation?

PHP Town Hall: Episode #13 - PHP Internals, Service-orientated Architecture and Language Wars


Community Events

Don't see your event here?
Let us know!


list api application symfony community laravel language project php7 series interview programming framework introduction yii2 part2 composer opinion example podcast

All content copyright, 2015 PHPDeveloper.org :: info@phpdeveloper.org - Powered by the Solar PHP Framework