search

asciidoctor / asciidoclet

:clipboard: A Javadoc Doclet based on Asciidoctor that lets you write Javadoc in the AsciiDoc syntax.
https://github.com/asciidoctor/asciidoclet
Apache License 2.0
133 stars 40 forks source link

Publish JavaDoc for AsciiDoclet #46

Closed msgilligan closed 8 years ago

msgilligan commented 8 years ago

It would be nice to see the JavaDoc for this project published. As I mentioned in a comment on another issue, I'm looking for examples of Asciidoclet being used in real-world projects. I decided to see if there was any dog-food eating going on -- and there was! -- but it would be nice to see the rendered HTML published somewhere.

johncarl81 commented 8 years ago

It's published on maven: https://oss.sonatype.org/service/local/repositories/releases/archive/org/asciidoctor/asciidoclet/1.5.2/asciidoclet-1.5.2-javadoc.jar/!/index.html

msgilligan commented 8 years ago

Cool! Should I add a link in the README and send a PR?

Update: "in the README"

msgilligan commented 8 years ago

I just noticed that the published link you provided was to a JAR file. I was also surprised to learn that Safari and Chrome will open and display it. Firefox doesn't, though. I don't know about IE.

I'll add the link to the README anyway, and maybe we can find a place to publish it as HTML.

msgilligan commented 8 years ago

PR #49 Adds a link to the published Maven JavaDoc JAR.

We could close this issue or leave it open to remind us to publish the JavaDoc somewhere as exploded HTML.

johncarl81 commented 8 years ago

Im comfortable closing this. I like the idea of publishing to a non-maven-central location, but I think it does the job.

johncarl81 commented 8 years ago

FYI: #55