cljdoc

https://cljdoc.org/ & https://github.com/cljdoc/cljdoc
dominicm 2020-09-09T17:16:49.023600Z

It's a shame the link can't be made to work "locally".

lread 2020-09-09T18:47:14.024900Z

@dominicm, if you mean when testing locally on your own computer, I am actually working on some url fixups.

dominicm 2020-09-09T19:19:44.025Z

I actually mean on github and on cljdoc

lread 2020-09-09T19:24:10.025200Z

Ah… ok, thanks for clarifying.

martinklepsch 2020-09-09T20:52:44.027100Z

Uhm, not sure that’s what you’re talking about but when you use a local markdown link the links on github will link to their github version and the links on cljdoc to their cljdoc Version

dominicm 2020-09-09T21:03:33.027300Z

Hmm, @seancorfield seemed to imply that wasn't the case :person_frowning:

lread 2020-09-09T21:03:36.027500Z

Lemme see if I understand, I think @seancorfield is linking from article to API, not via cljdoc wikilinks, but by full url because github does not render cljdoc wikilinks — and maybe @dominicm was saying it would be nice if you could stay on github if you started on github?

seancorfield 2020-09-09T21:05:53.027700Z

Linking from docs to API docs, yes.

seancorfield 2020-09-09T21:06:39.027900Z

So you have to have a full URL in the docs because on GH, where you have .md files, you still want folks to be able to click the link and end up on the API docs.

dominicm 2020-09-09T22:21:45.028100Z

Asciidoc has a file extension link system for this. So you can link to another page, and the suffix is chosen for you.