out of curiosity: does cljdoc also show javadocs for java sources in clojure projects?
I'm working on a Java API for one of my projects
@borkdude not in scope, sorry!
can probably hack around that by generating some markdown from javadoc or something
Happy to discuss if you feel thereโs a strong case for it but my intuition is that cost/benefit just doesnโt make much sense given the average Clojure library
you might be right
Generating documentation to markdown files ๐ ๐ Boot does that too, worked pretty well
or I'll just informally create an example. Java people have IDEs ๐
@martinklepsch hello ๐ I was having the wish to have some attribute documentation on cljdoc, in that I mean, having a section of the docs dedicated to talk about the keywords with spec information, this could include:
1. list of qualified keywords are used in the project (maybe even those without spec)
2. describe specs for keywords that have it
3. using data from fspec
/ fdef
it could generate a list of functions where that keyword is mentioned
I have done something similar for Pathom (https://wilkerlucio.github.io/pathom/v2/pathom/2.2.0/connect/exploration.html). what do you think about having something like this in cljdoc?
Could also have inline example generation for specced stuff.
@wilkerlucio Couldn't you just write that up in the doc
folder in your repo?
https://cljdoc.org/d/seancorfield/next.jdbc/1.0.9/doc/getting-started is an example of docs generated from https://github.com/seancorfield/next-jdbc/blob/master/doc/getting-started.md
Oh, you specifically want it auto-generated from the source?
I'm not sure how valuable auto-generated data would be -- I would expect it to need more curation?