Documenting new promises in lib/Facebook.js

[HassenIO]

Hi all, 👋

This follows my current work on "Allow Promises when on Facebook API calls" of botkit, actually still in PR #1520.

I would like to have a first feedback on how to properly document the promise way of some methods, in addition to the classical callback way.

Here is an example, currently in my fork https://github.com/htaidirt/botkit-docs/commit/c8f393ce2739d4c5fc3c7466650cd6608101d351. Given your feedbacks, I'll continue documenting similarly the remaining methods.

Thanks

[ouadie-lahdioui]

Hi @htaidirt, I've taken a look at your fork and it sounds great.

Go Go Go

[benbrown]

@htaidirt since the promise code has been released, let's get these docs updated!