https://kotlinlang.org logo
#random
Title
# random
c

christophsturm

09/29/2022, 11:32 AM
is there something like mdoc for kotlin? https://scalameta.org/mdoc/ it looks very useful.
c

corneil

09/29/2022, 5:08 PM
I use asciidoc and include existing code fragments that I need in the document
Here's an example: https://github.com/open-jumpco/kfsm/blob/main/src/docs/asciidoc/kfsm.adoc While using this in IntelliJ with the asciidoc plugin you will see the code in the preview
c

christophsturm

09/29/2022, 5:55 PM
thats a different way to get a comparable result, yes. there is also this: http://oneeyedmen.com/book-software-part-1.html but mdoc really seems like the most elegant solution IMO
c

corneil

09/29/2022, 6:30 PM
You could probably look at Jupyter notebooks with Kotlib support. I'm not sure if it does well enough on the documentation side. It has the benefit of supporting execution.