Squashed commit of the following:

commit 74fe221e21f4ed4e16b8da01c37837055df0222e
Author: Larry Hosken <lhosken@twitter.com>
Date:   Fri Feb 28 14:51:26 2014 -0800

    incorporate feedback

commit 99a982842bd1ec2b9233caba0a69fcf9c626ae13
Author: Larry Hosken <lhosken@twitter.com>
Date:   Fri Feb 28 08:58:51 2014 -0800

    docs: don't talk about Twitter's regretted published IDL consumption, yeesh.