Add table to simplify choosing a lift function
tweaks to "Which one should I use?" table

1. bold left-hand column
2. use when instead of when/function
3. Demonstrate that lifted function returns a promise
Merge pull request #339 from adamloving/patch-1

Update API doc: Add simple table for choosing a lift function