As a brand new member of the team, I'm really keen to hear more about how we've failed at our APIs and developer support and what we could do to be way better.
One of the few things I needed was an app request dialog. It didn't seem possible from the SDK docs (at least not clearly so), the only way was to use the deprecated global Facebook object:
http://stackoverflow.com/questions/13351584/how-to-send-user...
There was no definitive list of possible values for the dialog name or parameters either. Apparently "message" was being ignored, but only for "feed" dialogs...? Apparently there is a replacement now, but it's still in beta. How am I supposed to tell my clients what is possible (and sustainable) and what isn't?
https://developers.facebook.com/docs/howtos/send-requests-us...
The definitive list of properties for the request dialog is documented here https://developers.facebook.com/docs/reference/dialogs/reque...
Two examples of inconsistent documentation that I've seen while looking this information up:
The documentation for common dialog parameters still links to the deprecated API even though there are web and native dialogs now: https://developers.facebook.com/docs/reference/dialogs/
The iOS Games SDK refers to SDK 3.1 in its introduction but uses FBWebDialogs, and my old copy of the SDK (3.1.1) does not have them yet.