Added FB docs links, return object examples
Merge pull request #590 from aogilvie/update/readme-api

Added FB docs links, return object examples