clojure.spec/def 应该支持可选的文档字符串

Question

与 clojure.core/def 一样，clojure.spec/def 应该支持可选的文档字符串，因为通常人们喜欢像关键字命名一样更详细地描述规范。

Answer 1

评论由: dergutemoritz 制作

基于这个想法，我建议为注册的规范添加一级元数据支持，并在其中实现文档字符串（即与 vars 相同的方式）。

Answer 2

评论由: emergent-behavior 制作

嗨！我与同事刚刚在讨论这样一个功能的潜力。目前的状态如何？我在考虑可能做一个方案，但想先从社区获取反馈和指导。

Answer 3

评论由: alexmiller 制作

我们还没有推荐的方法来解决这个问题，因此目前不寻找补丁。

Answer 4

评论由：floybix

如果您正在优先处理这个问题，请记住还需要在规格中添加源（文件 + 行）元数据。这将使我们能够使用规格在自动生成的文档中，这非常高，尤其是当您可以链接到嵌套的规格时。请参见CLJ-2037 https://dev.clojure.org/jira/browse/CLJ-2037

Answer 5

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