Docs updates: return values of promises.  study ids.