[doc] Misc housekeeping

main/src/taoensso/telemere/consoles.cljc

@@ -1,6 +1,5 @@
 (ns ^:no-doc taoensso.telemere.consoles
-  "Private ns, implementation detail.
-  Core console handlers, aliased in main Telemere ns."
+  "Telemere -> console handlers."
   (:require
    [taoensso.truss          :as truss]
    [taoensso.encore         :as enc]

main/src/taoensso/telemere/files.clj

@@ -1,6 +1,5 @@
 (ns ^:no-doc taoensso.telemere.files
-  "Private ns, implementation detail.
-  Core file handler, aliased in main Telemere ns."
+  "Telemere -> file handler."
   (:require
    [taoensso.truss  :as truss]
    [taoensso.encore :as enc]

main/src/taoensso/telemere/open_telemetry.clj

@@ -1,7 +1,9 @@
 (ns taoensso.telemere.open-telemetry
-  "OpenTelemetry handler using `opentelemetry-java`,
-    Ref. <https://github.com/open-telemetry/opentelemetry-java>,
-         <https://javadoc.io/doc/io.opentelemetry/opentelemetry-api/latest/index.html>"
+  "Telemere -> OpenTelemetry handler using `opentelemetry-java`,
+  Ref. <https://github.com/open-telemetry/opentelemetry-java>,
+       <https://javadoc.io/doc/io.opentelemetry/opentelemetry-api/latest/index.html>
+
+  Telemere will attempt to load this ns automatically when possible."
   (:require
    [clojure.string  :as str]
    [clojure.set     :as set]

main/src/taoensso/telemere/postal.clj

@@ -1,6 +1,6 @@
 (ns taoensso.telemere.postal
-  "Email handler using `postal`,
-    Ref. <https://github.com/drewr/postal>."
+  "Telemere -> email handler using `postal`,
+  Ref. <https://github.com/drewr/postal>."
   (:require
    [taoensso.truss          :as truss]
    [taoensso.encore         :as enc]

main/src/taoensso/telemere/slack.clj

@@ -1,6 +1,6 @@
 (ns taoensso.telemere.slack
-  "Slack handler using `clj-slack`,
-    Ref. <https://github.com/julienXX/clj-slack>"
+  "Telemere -> Slack handler using `clj-slack`,
+  Ref. <https://github.com/julienXX/clj-slack>"
   (:require
    [taoensso.truss  :as truss]
    [taoensso.encore :as enc]

main/src/taoensso/telemere/sockets.clj

@@ -1,5 +1,5 @@
 (ns taoensso.telemere.sockets
-  "Basic TCP/UDP socket handlers."
+  "Telemere -> TCP/UDP socket handlers."
   (:require
    [taoensso.truss  :as truss]
    [taoensso.encore :as enc]

main/src/taoensso/telemere/streams.clj

@@ -1,5 +1,5 @@
 (ns taoensso.telemere.streams
-  "Interop support for standard stream/s -> Telemere."
+  "Standard streams -> Telemere interop."
   (:require
    [taoensso.encore        :as truss]
    [taoensso.encore        :as enc]

main/src/taoensso/telemere/tools_logging.clj

@@ -1,5 +1,5 @@
 (ns taoensso.telemere.tools-logging
-  "Interop support for tools.logging -> Telemere.
+  "tools.logging -> Telemere interop.
   Telemere will attempt to load this ns automatically when possible.
 
   Naming conventions:

slf4j/src/taoensso/telemere/slf4j.clj

@@ -1,5 +1,5 @@
 (ns taoensso.telemere.slf4j
-  "Interop support for SLF4Jv2 -> Telemere.
+  "SLF4Jv2 -> Telemere interop.
   Telemere will attempt to load this ns automatically when possible.
 
   To use Telemere as your SLF4J backend/provider, just include the