Fork me on GitHub
#cljdoc
<
2019-11-15
>
seancorfield03:11:24

Two questions: 1. I just published 1.0.10 of seancorfield/next.jdbc -- and noticed an unfortunate broken link in the Getting Started docs. I can fix it on GitHub of course, but what will it take to get cljdoc to rebuild the docs from that fixed version? 2. I have a namespace that only contains implementations of protocols, so it has no vars and does not show up in the left hand nav tree of namespaces. I feel like I've asked this before but is there a way to force cljdoc to include such namespaces in the nav tree?

seancorfield03:11:39

(I suspect the answer to #1 is "You have to release a new build" which seems overkill just to fix a link in the generated documentation 😞 )

martinklepsch10:11:57

@seancorfield Your suspicion is correct. I wish there was another way but so far I haven’t found a method that I’m completely happy with. This is currently also a ~blocker for Reagent to use cljdoc so probably worth addressing

martinklepsch10:11:32

There’s an issue for this here, feel free to subscribe and give feedback on solutions have have been proposed thus far https://github.com/cljdoc/cljdoc/issues/31#issuecomment-554298351

martinklepsch10:11:39

More ideas also welcome 🙂

martinklepsch10:11:28

Regarding #2 — is the namespace next.jdbc.transaction? If so what would you like to see when viewing that namespace on cljdoc?

martinklepsch16:11:56

We could add it to the nav if there is a docstring, if you’d like that leave a not here: https://github.com/cljdoc/cljdoc/issues/21

seancorfield16:11:05

Okay I'll add a vote for it there. The actual page renders fine. They're just missing from the nav tree.

martinklepsch16:11:51

Yeah, at some point I took them out because I thought it doesn’t make sense to just show a namespace’s title. I didn’t consider that there might be an extensive docstring at the time.

seancorfield18:11:04

Notes added to both tickets.

martinklepsch18:11:04

> Can you also make it a bit easier to figure out how to request a cljdoc rebuild? As in the hidden button is too hidden?

seancorfield19:11:22

There's a hidden button? Where is it?

dominicm22:11:19

it's white text

dominicm22:11:29

to the immediate left of the button in the top right.

dominicm22:11:32

inspect the source

seancorfield23:11:38

Found it -- thanks @dominicm!