Clojurians Log v2

Really cool, I started writing something like this for Kaocha

I feel like I just added the source-location viewer, it's cool to see it getting usage here! It looks like you made really good use of the hiccup + portal viewers in general in your implementation 👏

Our of curiosity, how did you go about building this / finding out all the Portal bits you needed to know to get this working?

In terms of...? Presumably the hiccup support for nested viewers? I saw hiccup support and figured "If I implemented this, I'd have made a way to nest custom viewers in it". Since I didn't see it mentioned in the docs I went to the hiccup viewer source and read what it does 😂. Found a couple usages in the cljdoc viewer. While looking at the clj doc viewer I realized it's what rendered the help system, and looking at that I found example usages for the source location viewer and relative time viewer.

Yeah, I think the hiccup nested viewer thing may only be mentioned in https://cljdoc.org/d/djblue/portal/0.48.0/doc/guides/default-viewer 😂 It might also be good idea to have a guide dedicated to it directly 👌

Any suggestions for what else may have made finding things easier?

Mention really high up in the readme the portal/doc function, and 1. say that it's not the same as the cljdoc wiki, and 2. it shows examples of existing custom viewers. That would help alot 🙂

maybe add a oneliner clj -A .. -X that launches the doc page would be great too

I probably won't be able to get to it for a bit. If you feel up to it, a PR would be awesome 👌