Am I blind or are the <API docs> not actually link...

# http4k

[Yogi]

Am I blind or are the API docs not actually linked to from the documentation?

[dave]

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).

[Yogi]

ah that’s why. i believe just a google search

[dave]

The best documentation is the tests 😉

[Yogi]

hah, not quite the same but point taken

[Yogi]

and hey, at least there are (sane + navigable) tests

[dave]

The developers of http4k are too stupid to be trusted to work without tests. 🙃

[Yogi]

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)

[Yogi]

not a complaint, just a note as i convince people to use this instead of big bad spring

[dave]

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.

[dave]

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 ! 😉 )

[Yogi]

yeah it’s nice to smoothly get folks to get it

[Yogi]

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!

[dave]

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! 🤣

[Yogi]

haha