cljdoc

https://cljdoc.org/ & https://github.com/cljdoc/cljdoc
ikitommi 2019-05-12T18:22:10.041900Z

ikitommi 2019-05-12T18:23:10.043600Z

not sure what found the error, but πŸ‘

martinklepsch 2019-05-12T18:26:50.044900Z

@ikitommi hm I'm confused by this, it seems like you removed the doctree from cljdoc.edn? The failing build is caused by this step:

- run:
    name: Verify cljdoc.edn
    command: curl -fsSL <https://raw.githubusercontent.com/cljdoc/cljdoc/master/script/verify-cljdoc-edn> | bash -s doc/cljdoc.edn

ikitommi 2019-05-12T18:42:59.046100Z

@martinklepsch oh, so if the file exists, I have to define the docs? Wanted to test auto-discovering the docs, but to use the :cljdoc/include-namespaces-from-dependencies.

martinklepsch 2019-05-12T18:45:37.047Z

That this fails when there is no doctree is a bug but also with your amount of docs I'd guess the added structure is quite helpful for people

ikitommi 2019-05-12T18:55:04.048500Z

Added those back, with the new pages. The docs are already in folders, could add the numbering to get those in order. But this is fine now, just need to remeber to add the files both to gitbook index & cljdoc index

martinklepsch 2019-05-12T19:10:01.050400Z

I guess you could use one to generate the other but yeah, having two things makes things a little more complicated

martinklepsch 2019-05-12T19:11:37.051500Z

Besides keyboard navigation what else would be needed to completely remove the need for gitbook for you?

ikitommi 2019-05-12T19:15:46.053Z

let me think… β€’ auto-update (each commit on master would build the MASTER docs without re-tagging / re-creating) β€’ (keyboard navigation)

ikitommi 2019-05-12T19:17:20.053900Z

the find is also neat on gitbook

ikitommi 2019-05-12T19:17:51.054500Z

would like to help doing those, but busy in all the ways with everything 😞

ikitommi 2019-05-12T19:18:11.054800Z

gitbook search

martinklepsch 2019-05-12T19:18:15.055300Z

No worries Tommi!

ikitommi 2019-05-12T19:18:25.055700Z

^:--- the search over all pages

martinklepsch 2019-05-12T19:19:06.056800Z

For search I also considered a more fluid reading experience with all content on the same page (which would enable cmd -f)

πŸ‘ 1