Since people might be confused by the purpose of a `Promise<Unit>` we should highlight that it could be completed with an exception, e.g.

> @return A promise giving the result of attempting to complete this promise with the `other` promise. If the completion was successful then the result will be a `null` value, if the completion failed then the result will be an `IllegalStateException`.