The Grammys Of Documentation

Do you ever get tired of how language designers seem to think you can read their minds? Looking up the answer to one question just leads to more questions, which leads to more questions… until suddenly the hardest choice you have to make is whether to use Breadth-First-Search or Depth-First-Search on this website to get to the answer most effectively. Whatever happened to “clear and concise documentation”? I may spent my whole life in search of this mythical creature, but I will be sure to record my journey here for all you lucky folks. Or, at least, the treasures I have found along the way.

And the award for Best Documentation goes to:

QlikView: VB Scripting API
Django: Django Homepage
PHP: PHP Manual

If you have more nominees (especially for categories I don’t yet have), please leave them in comments 🙂


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s