It's a shame the link can't be made to work "locally".
@dominicm, if you mean when testing locally on your own computer, I am actually working on some url fixups.
I actually mean on github and on cljdoc
Ah… ok, thanks for clarifying.
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
Hmm, @seancorfield seemed to imply that wasn't the case :person_frowning:
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?
Linking from docs to API docs, yes.
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.
Asciidoc has a file extension link system for this. So you can link to another page, and the suffix is chosen for you.