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 汇报）