请求在 (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 新手 people

见

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

Stack Overflow 帖子的作者错过了单词 "successive"（或者完全忽略了 API 文档）。

---

感谢花时间回复。