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

Question

请求更改 (doc take-while)

目前它说

---

clojure.core/take-while
([pred] [pred coll])
在 (pred item) 返回逻辑真时 返回 coll 的连续元素序列。
pred 必须无副作用。
不提供集合时返回转换器。

更改为

---

clojure.core/take-while
([pred] [pred coll])
在 (pred item) 返回逻辑真时 返回 coll 的连续元素序列。
(pred item) 返回逻辑真 并停止在第一个假的地方。pred 必须无副作用。
不提供集合时返回转换器。

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

见

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

Answer 1

嗨，感谢您的建议，但我不认为我们会更改这一点。

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

Clojure 核心文档字符串的语句非常经济。它们当然不完美，几乎每个 Clojure 版本都有文档字符串更新，所以我们愿意在有必要的地方更改它们，但我不认为这里是这种情况。

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

Comments

StackOverflow的发布者遗漏了单词"successive"（或者完全没有查阅API文档）。

---

感谢您花时间回复。