https://pantsbuild.org/ logo
i

icy-hair-30586

04/05/2022, 4:41 PM
If I wanted to add a documentation generation step with https://pdoc3.github.io/pdoc/ , am I correct to assume that I should handle it as a codegen plugin and start from the codegen tutorial? Is there anything similar for javadoc that I could replicate?
h

hundreds-father-404

04/05/2022, 4:52 PM
Possibly, but it might also makes sense to create a custom doc goal. I I don't think we have any special Java Doc integration yet. Do you know already how you would do this without pants, eg the argv to run?
w

witty-crayon-22786

04/05/2022, 5:07 PM
it’s also possible that
package
+ a specific documentation target would make sense
đź’Ż 1
h

happy-kitchen-89482

04/05/2022, 6:14 PM
Not sure about that
Or maybe yes? Can bikeshed 🙂
w

witty-crayon-22786

04/05/2022, 7:28 PM
my thinking with the documentation target is that generally people want a documentation artifact (something that they can
publish
somewhere)
âž• 1
although Java/Scala support a special artifact type “attached” to a JAR, it’s frequently also the case that people want to publish the documentation to be hosted on an HTTP server, for example. and that latter case (“documentation artifact”) is a common thread across all languages i’ve encountered… sphinx, javadoc, cargo doc, etc
âž• 1
it’s also usually the case that your published API docs in monorepos are monolithic… repo or project wide, basically. it’s rare for them to be per-library.
h

happy-kitchen-89482

04/06/2022, 12:26 AM
True, and there is probably artifact-specific config (e.g., HTTP style information) that needs to go somewhere
👍 1
3 Views