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 提出）