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

Question

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

Answer 1

由 dergutemoritz 发表的评论

在这个想法的基础上，我建议为已注册的规范添加一等元数据支持，并从那个角度实现文档字符串（即变量的相同方式）。

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