Comment by douglasp

I agree with most of the comments here and on the blog post; having hit many of the same issues myself.

Fortunately, I get to do something about it.

I work for Facebook (joined ~3 weeks ago).

Part of my job is to help fix the developer site, documentation, etc. (along with a host of other issues related to developer relations).

We are working on updating the site and docs as fast as we can and this thread is helpful.

If you have any issues/feedback/whatever with our platform docs or API, email me at [email protected] and we'll get them addressed as soon as we can.