cljdoc tweaks (#288)

Author: borkdude

README.md

@@ -2,6 +2,7 @@
 
 [![CircleCI](https://circleci.com/gh/borkdude/speculative/tree/master.svg?style=svg)](https://circleci.com/gh/borkdude/speculative/tree/master)
 [![Clojars Project](https://img.shields.io/clojars/v/speculative.svg)](https://clojars.org/speculative)
+[![cljdoc badge](https://cljdoc.org/badge/speculative/speculative)](https://cljdoc.org/d/speculative/speculative/CURRENT)
 
 speculative is a collection of specs for the functions in `clojure.core`. While
 its ultimate goal is to be rendered obsolete by these or similar specs being

doc/users.md

@@ -2,3 +2,4 @@
 
 - [Rollcage](https://github.com/circleci/rollcage), a Clojure client for Rollbar
 - [Planck](https://github.com/planck-repl/planck), a stand-alone ClojureScript REPL
+- [Re-find](https://re-find.it), an app to find Clojure functions using specs.

src/speculative/instrument.cljc

@@ -1,7 +1,8 @@
 (ns speculative.instrument
-  "Loads all relevant speculative specs. Provides functions to only
-  instrument and unstruments specs provided by speculative. Alpha,
-  subject to change."
+  "Loads all relevant speculative specs. Undefines specs that are not
+  suited or useful to instrument and therefore makes it safe to
+  call `(stest/instrument)`. Provides functions to only instrument and
+  unstruments specs provided by speculative."
   (:require
    [clojure.set :as set]
    [clojure.string :as str]
@@ -36,7 +37,7 @@
 
 (impl/deftime
   (defmacro unload-blacklist
-    "Make it safe to call (stest/instrument) by unloading blacklisted
+    "Make it safe to call `(stest/instrument)` by unloading blacklisted
   specs. Respects environment variable
   `SPECULATIVE_NO_UNLOAD_BLACKLIST` or `goog-define`
   `no-unload-blacklist?`, unless `force?` is true. To undo unloading

src/speculative/specs.cljc

@@ -6,7 +6,7 @@
    [clojure.spec.gen.alpha :as gen]
    #?(:cljs [goog.string])))
 
-#?(:cljs (def ^:private ^:no-doc
+#?(:cljs (def ^:private
            before-1_10_439?
            (and *clojurescript-version*
                 (pos? (goog.string/compareVersions "1.10.439"