Humans learn better when they can play with what they're working with, when they can poke at it and understand what happens to B when you change A. The browser provides a wonderful place where examples can be interactive, and yet most documentation for javascript APIs doesn't make use of these capabilities.
Codeblock.js turns example code into editable, runnable code blocks that visitors can poke at and play with to better understand your API.