Clojurians Log v2

very much an aside but part of this search work has me pulling functionality out of request handlers and making them available as functions. ideally, for me, request handlers should be doing as little as possible such that they only contain the things that are specific to http request handling

https://github.com/cljdoc/cljdoc/pull/572/files#diff-5976da524ac1aa4154f6c985451ee3b8595819a01653f8419981cdc899171205

you can see the two parts I pulled out in that file

so things like extracting parameters, loading things from the config, etc, can be in the handler but there are only one or two function calls. that way the request handling details are decoupled from the functionality

I've noticed this a lot in clojure projects, fwiw. there doesn't seem to be much of a sense of where to separate things within request handlers. in ruby, at least, there's a strong focus on request handlers being as simple as possible

in the rails world they have a phrase for it: "fat model, skinny controller"

but really it's about separation of concerns and making code as re-usable as possible

I think in a functional world that's even more important since we can compose functions so easily it makes re-use even more valuable

my thoughts aren't 100% fully formed but I thought I'd share

Cool, more unit-testable too, I assume.

absolutely

maybe we should split single docset search from finding functions/namespaces by name

I'm having such a hard time getting the search to work like I'd expect

lunr offers highlighting but the search isn't as good. flexsearch has fantastic search but no highlighting

wat do

really, funding the right function/namespace could be like a fuzzy finder with some levenshtein distance checks, but searching docs is more of a full-text search problem

and I think this is why I'm struggling

think of it like searching a project on github vs hitting t and doing fuzzy file finding

And then there are the docstrings too.

I’m not sure what kind of sophistication cljdoc users would be expecting. They’ll probably be very happy with whatever first cut you come up with! Maybe if you tokenize in such a way that both words and symbols can be found, you might have a good first cut?

that's the thing, they're not terribly configurable

i'll need to play around more

hey waddya think of?

(this is in the theme of libraries search work and the idea you should see the freetext content that you are searching)

it could use some spacing and increase in font size, I think

maybe put clojars on the same line as the version and move view docs down beneath it

it's pretty sweet

I like that I can see the description

Hi! Is it possible to host a private documentation for the companies project? I love cljdoc documentation and things but as I found so far, it only offers for public.