Deliver的文档字符串应描述其返回值

Question

在交付承诺时，了解交付是否成功是有用的（如果它在另一个线程上可能已经交付，可能会失败）。

看起来{{deliver}}函数通过在成功时返回真实的值（承诺本身）和失败时返回假值（{{nil}}）来传达这一点。如果这是故意为之，文档字符串应该说明这一点，以便用户可以放心地依赖于它。

在CLJ-1038中，Rich选择了不描述返回值；我不确定这是否是由于不愿意完全指定返回值（承诺与{{nil}}）甚至如果部分描述它（真实与假）是可以接受的。

Answer 1

参考：https://clojure.atlassian.net/browse/CLJ-1542（由gfredericks报告）