documentation+optionals

tons of documentation to each method and now optional arguments are now
available for most api calls (graph methods coming soon)