DOC: adding documentation about the promises library