document that #publish returns a promise

[dustinsmith1024]

I had some issues thinking that publish was synchronous. Might be nice to add an example or some doc that it is actually async.

I can write up the example, just wanted to make the issue while I was thinking about it.