Begin documenting promises in more detail.