This page is not created by, affiliated with, or supported by Slack Technologies, Inc.
2023-08-16
Channels
- # announcements (25)
- # babashka (15)
- # beginners (14)
- # calva (60)
- # circleci (1)
- # clerk (1)
- # clj-kondo (13)
- # cljdoc (7)
- # clojure (45)
- # clojure-austin (1)
- # clojure-bay-area (1)
- # clojure-brasil (4)
- # clojure-dev (9)
- # clojure-europe (24)
- # clojure-norway (105)
- # clojure-uk (2)
- # clojurescript (6)
- # conjure (1)
- # core-typed (4)
- # cursive (4)
- # datalevin (1)
- # datomic (25)
- # emacs (31)
- # fulcro (3)
- # humbleui (10)
- # hyperfiddle (19)
- # jobs (2)
- # luminus (3)
- # malli (13)
- # nbb (5)
- # off-topic (16)
- # polylith (2)
- # portal (7)
- # releases (2)
- # shadow-cljs (5)
- # sql (8)
In Cljdoc, API Wikilinks seem to be randomly failing when using alias instead of fully-qualified namespaces.
For instance, in https://cljdoc.org/d/com.nilenso/goose/0.3.2/api/goose.client#keys, [[d/default-queue]]
is broken whereas [[retry/default-opts]]
was linked accurately.
Please find reference to https://github.com/nilenso/goose/blob/0fecb553457e3f7b1655a1eca63b2491166aaeec/src/goose/client.clj#L21.
> Is this a bug or is there a nuance that I'm missing?
Hi @U03HVBGMRJ5! Cljdoc wikilinks do not recognize namespace aliases. Here are relevant docs: https://github.com/cljdoc/cljdoc/blob/master/doc/userguide/for-library-authors.adoc#use-api-wikilinks-from-docstrings. The [[retry/default-ops]]
works because it is recognized as a relative wikilink. Personally, I find the relative syntax confusing and just fully qualify my wikilinks.
Thanks @UE21H2HHD for the prompt response. > Note that if you want to link to vars outside the current namespace you need to either fully qualify those vars or specify them relative to the current namespace This line wasn't clear to me before, but is now after your explanation. Maybe we can explicitly say that users shouldn't reference namespaces via aliases.
Yes, good idea, if you were confused, others will be too. I'll make a small update to the docs there.

@U03HVBGMRJ5 here's my update https://github.com/cljdoc/cljdoc/blob/master/doc/userguide/for-library-authors.adoc#use-api-wikilinks-from-docstrings, I think that it is clearer. Thanks for the feedback.
