Fork me on GitHub
#cljdoc
<
2021-01-11
>
clyfe18:01:04

Can cljdoc render docstrings as asciidoc (instead markdown)?

martinklepsch20:01:10

No. Kind of an intentional decision in the beginning to not fragment the community

clyfe20:01:59

I'd like to implement that, and trigger it by a manifest entry

clyfe20:01:02

I'd like to not go half adoc half md in my project :thinking_face:

lread20:01:16

My general preference is also AsciiDoc @UCCHXTXV4, but am personally fine with CommonMark only for docstrings. I don’t tend to use any complex markdown in docstrings - for what syntax I do use, the CommonMark is similar enough to AsciiDoc that I don’t get too muddled in the brain.

lread20:01:22

That, and it keeps cljdoc the code base simpler!

clyfe20:01:16

so... pr welcome?

lread22:01:14

I’m personally not interested in the added complexity and maintenance cost. But @U050TNB9F would be the one to answer that! simple_smile

lread19:01:34

Thanks @UCCHXTXV4, I added in my comments from here on Slack to the issue!

👍 3