请求修改 (doc take-while) 中的文档字符串

Question

请求修改 (doc take-while)

目前它写着

---

clojure.core/take-while
([pred] [pred coll])
返回一个从 coll 中按顺序获取的惰性序列，直到 (pred item) 返回逻辑真。
pred 必须无菌侧效应。
在未提供集合时返回转换器。

修改为

---

clojure.core/take-while
([pred] [pred coll])
返回一个从 coll 中按顺序获取的惰性序列，直到 (pred item) 返回逻辑真。
(pred item) 返回逻辑真 并在首次出现 false 停止。 pred 必须无菌侧效应。
在未提供集合时返回转换器。

这可能会让编程/Clojure 新手感到困惑

参考

https://stackoverflow.com/questions/69845947/why-is-take-while-returning-empty-sequence

Answer 1

你好，感谢你的建议，但我不认为我们会修改这一点。

"当 (pred item) 返回逻辑真时"就足够了 - "当"意味着"当条件成立时"（而不是当条件不成立时）。"我在洗澡时唱歌"不需要也说我"从浴室出来时停止唱歌"。

Clojure 核心文档字符串故意非常精简。它们当然不完美，Clojure 几乎每个版本都有文档字符串更新，所以我们乐于在有道理的地方修改它们，但我不认为这里是这样。

许多新手需要更多信息，我们有很多辅助资源，如https://docs.clojure.org/clojure.core/take-while，Clojure 用户可以在那里提供示例、附加注释、链接等来补充核心文档字符串。Clojure 技巧表（https://clojure.org/api/cheatsheet）也提供了进入 ClojureDocs 的链接。

Comments

StackOverflow的发帖者错过了单词"successive"（或者根本没有看到API文档）。

---

感谢您花时间回复。