https://kotlinlang.org logo
#http4k
Title
# http4k
y

Yogi

11/02/2023, 2:43 PM
Am I blind or are the API docs not actually linked to from the documentation?
d

dave

11/02/2023, 2:49 PM
Where did you find the link to the API docs - we should remove it as they are out of date. Basically we stopped outputting the API docs when Dokka started running out of memory during the build (ages and ages ago).
y

Yogi

11/02/2023, 9:54 PM
ah that’s why. i believe just a google search
d

dave

11/02/2023, 9:55 PM
The best documentation is the tests 😉
y

Yogi

11/02/2023, 9:56 PM
hah, not quite the same but point taken
and hey, at least there are (sane + navigable) tests
d

dave

11/02/2023, 9:57 PM
The developers of http4k are too stupid to be trusted to work without tests. 🙃
🤣 1
y

Yogi

11/02/2023, 10:00 PM
yes but my devs might be too stupid slow to use tests as a reference 🫠 honestly though, from a total noob perspective it feels like a big piece missing from the otherwise easy to read documentation (thank you)
not a complaint, just a note as i convince people to use this instead of big bad spring
❤️ 1
d

dave

11/02/2023, 10:01 PM
We really wanted to keep it in but dokka kept OOMing and breaking our build. Not sure if it's better now... We are running at about 80 modules so it's possible the GHA runners aren't you to the job.
We try to keep examples in executable form as it seems to be a better fit. If there are "how to"s missing then we can always add them (with a bit is community spirit OFC ! 😉 )
💯 1
y

Yogi

11/02/2023, 10:03 PM
yeah it’s nice to smoothly get folks to get it
i can say i’ll try but you’ve probably heard that a thousand times. i can at least say thank you for providing great examples of how building and testing can be far simpler than what most folks are used to. i’m trying to get some jr devs to see the light before it’s too late!
d

dave

11/02/2023, 10:07 PM
Tbh it's mostly to remind us how to do it! There's so much now that (I at least) regularly forget things that have been written! 🤣
y

Yogi

11/02/2023, 10:07 PM
haha