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