Clojure

clojure.spec/def should support an optional doc-string

Details

  • Type: Feature Feature
  • Status: Open Open
  • Priority: Minor Minor
  • Resolution: Unresolved
  • Affects Version/s: Release 1.9
  • Fix Version/s: Release 1.9
  • Component/s: None
  • Labels:
  • Approval:
    Vetted

Description

Like clojure.core/def clojure.spec/def should support an optional doc string because one usually likes to describe specs in more detail as one could through keyword naming.

Activity

Hide
Moritz Heidkamp added a comment -

Building on this idea, I suggest to add first-class metadata support to registered specs and implement doc strings in terms of that (i.e. the same way as with vars).

Show
Moritz Heidkamp added a comment - Building on this idea, I suggest to add first-class metadata support to registered specs and implement doc strings in terms of that (i.e. the same way as with vars).
Hide
Josh Brandoff added a comment -

Hi! Was just discussing the potential for a feature like this with a colleague. What's the current status? Was thinking of potentially working on it but wanted to get feedback and guidance from the community first.

Show
Josh Brandoff added a comment - Hi! Was just discussing the potential for a feature like this with a colleague. What's the current status? Was thinking of potentially working on it but wanted to get feedback and guidance from the community first.
Hide
Alex Miller added a comment -

We don't have a recommended approach to this yet so not looking for a patch at this time.

Show
Alex Miller added a comment - We don't have a recommended approach to this yet so not looking for a patch at this time.

People

Vote (43)
Watch (16)

Dates

  • Created:
    Updated: