Email or username:

Password:

Forgot your password?
(λ.'s posts Post Back to profile
(λ. borkdude)

I'm considering using mkdocs-material for documentation for #babashka.

Current:
book.babashka.org

With mkdocs-material it would look like:
calva.io
clojure-lsp.io

Benefit of the current "basic" approach is that Cmd-f works for searching. WDYT?

Anonymous poll

Poll

Current docs
15
0%
mkdocs-material
1
0%
0 people voted.
Voting ended 4 Dec 2022 at 10:19.
3 Dec 2022 at 10:19 | Open on mastodon.social
7 comments
Tim Zöller

@borkdude I really like single page documentations which are Strg-F-able, comes in handy when I'm not sure what I'm looking for. The official documentation for the Spring Framework switched away from a single page doc that was searchable and faced some criticism for it

3 Dec 2022 at 10:24 | Open on freiburg.social
hansenpansen

@borkdude I really like the generated layout of AsciiDoctor. It looks more professional. So I voted for the current approach.

3 Dec 2022 at 10:48 | Open on mastodon.social
(λ. borkdude)

@hansenpansen @javahippie

One could wonder why asciidoc moved to antora, which is similar t mkdocs:

docs.asciidoctor.org/

3 Dec 2022 at 11:57 | Open on mastodon.social
Remco

@borkdude :cough: texinfo pages :cough: can generate single and multi page HTML and PDFs. Also integrates nicely in some IDEs. 😁

3 Dec 2022 at 12:13 | Open on mastodon.social
Go Up