JavaDoc for the Asciidoctor Java libraries

I'd like to host or link to the JavaDoc for the Asciidoctor Java libraries.

One solution is to link to the JavaDoc that is exposed via the Maven central repo:

https://oss.sonatype.org/service/local/repositories/releases/archive/org/asciidoctor/asciidoctor-java-integration/0.1.2.1/asciidoctor-java-integration-0.1.2.1-javadoc.jar/!/index.html

That's nice because it's easy to maintain...just update the main link when a new release is available and add a new link to the history list.

I'm pretty sure the content displayed is exactly what's contained in the javadoc artifact. The only downside is that we can't update the style for old versions. I guess the other downside is the URL is not so pretty, but if we link to it that's not much of a problem.

WDYT? Is the best solution just to link there for now?

-Dan

--

Dan Allen | http://google.com/profiles/dan.j.allen

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

We're already using an awestruct site, why not just scrape the URL and rework it?

On Thu, May 23, 2013 at 12:14 PM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:

I'd like to host or link to the JavaDoc for the Asciidoctor Java libraries.

One solution is to link to the JavaDoc that is exposed via the Maven central repo:

https://oss.sonatype.org/service/local/repositories/releases/archive/org/asciidoctor/asciidoctor-java-integration/0.1.2.1/asciidoctor-java-integration-0.1.2.1-javadoc.jar/!/index.html

That's nice because it's easy to maintain...just update the main link when a new release is available and add a new link to the history list.

I'm pretty sure the content displayed is exactly what's contained in the javadoc artifact. The only downside is that we can't update the style for old versions. I guess the other downside is the URL is not so pretty, but if we link to it that's not much of a problem.

WDYT? Is the best solution just to link there for now?

-Dan

--

Dan Allen | http://google.com/profiles/dan.j.allen

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

--

Jason Porter
http://en.gravatar.com/lightguardjp

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228p229.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

W

​ell, the reasoning is...if it's already on the net, why not link to it?

-Dan​

On Thu, May 23, 2013 at 12:37 PM, lightguard.jp [via Asciidoctor :: Discussion] <[hidden email]> wrote:

We're already using an awestruct site, why not just scrape the URL and rework it?

On Thu, May 23, 2013 at 12:14 PM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:

I'd like to host or link to the JavaDoc for the Asciidoctor Java libraries.

One solution is to link to the JavaDoc that is exposed via the Maven central repo:

https://oss.sonatype.org/service/local/repositories/releases/archive/org/asciidoctor/asciidoctor-java-integration/0.1.2.1/asciidoctor-java-integration-0.1.2.1-javadoc.jar/!/index.html

That's nice because it's easy to maintain...just update the main link when a new release is available and add a new link to the history list.

I'm pretty sure the content displayed is exactly what's contained in the javadoc artifact. The only downside is that we can't update the style for old versions. I guess the other downside is the URL is not so pretty, but if we link to it that's not much of a problem.

WDYT? Is the best solution just to link there for now?

-Dan

--

Dan Allen | http://google.com/profiles/dan.j.allen

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

--

Jason Porter
http://en.gravatar.com/lightguardjp

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228p229.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

--

Dan Allen | http://google.com/profiles/dan.j.allen

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228p230.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

You were talking about changing the css or something I thought.

On Thu, May 23, 2013 at 12:54 PM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:

W

​ell, the reasoning is...if it's already on the net, why not link to it?

-Dan​

On Thu, May 23, 2013 at 12:37 PM, lightguard.jp [via Asciidoctor :: Discussion] <[hidden email]> wrote:

We're already using an awestruct site, why not just scrape the URL and rework it?

On Thu, May 23, 2013 at 12:14 PM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:

I'd like to host or link to the JavaDoc for the Asciidoctor Java libraries.

One solution is to link to the JavaDoc that is exposed via the Maven central repo:

https://oss.sonatype.org/service/local/repositories/releases/archive/org/asciidoctor/asciidoctor-java-integration/0.1.2.1/asciidoctor-java-integration-0.1.2.1-javadoc.jar/!/index.html

That's nice because it's easy to maintain...just update the main link when a new release is available and add a new link to the history list.

I'm pretty sure the content displayed is exactly what's contained in the javadoc artifact. The only downside is that we can't update the style for old versions. I guess the other downside is the URL is not so pretty, but if we link to it that's not much of a problem.

WDYT? Is the best solution just to link there for now?

-Dan

--

Dan Allen | http://google.com/profiles/dan.j.allen

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

--

Jason Porter
http://en.gravatar.com/lightguardjp

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228p229.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

--

Dan Allen | http://google.com/profiles/dan.j.allen

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228p230.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

--

Jason Porter
http://en.gravatar.com/lightguardjp

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228p231.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Right, but then we would just add the JavaDoc build into the Awestruct build rather than scrape.

I think short term solution the best is just to link to it. Then, we can change to a local build once we outgrow it.

I'll add the JavaDoc link to the docs page now.

-Dan

On Thu, May 23, 2013 at 12:59 PM, lightguard.jp [via Asciidoctor :: Discussion] <[hidden email]> wrote:

You were talking about changing the css or something I thought.

On Thu, May 23, 2013 at 12:54 PM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:

W

​ell, the reasoning is...if it's already on the net, why not link to it?

-Dan​

On Thu, May 23, 2013 at 12:37 PM, lightguard.jp [via Asciidoctor :: Discussion] <[hidden email]> wrote:

We're already using an awestruct site, why not just scrape the URL and rework it?

On Thu, May 23, 2013 at 12:14 PM, mojavelinux [via Asciidoctor :: Discussion] <[hidden email]> wrote:

I'd like to host or link to the JavaDoc for the Asciidoctor Java libraries.

One solution is to link to the JavaDoc that is exposed via the Maven central repo:

https://oss.sonatype.org/service/local/repositories/releases/archive/org/asciidoctor/asciidoctor-java-integration/0.1.2.1/asciidoctor-java-integration-0.1.2.1-javadoc.jar/!/index.html

That's nice because it's easy to maintain...just update the main link when a new release is available and add a new link to the history list.

I'm pretty sure the content displayed is exactly what's contained in the javadoc artifact. The only downside is that we can't update the style for old versions. I guess the other downside is the URL is not so pretty, but if we link to it that's not much of a problem.

WDYT? Is the best solution just to link there for now?

-Dan

--

Dan Allen | http://google.com/profiles/dan.j.allen

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

--

Jason Porter
http://en.gravatar.com/lightguardjp

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228p229.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

--

Dan Allen | http://google.com/profiles/dan.j.allen

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228p230.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

--

Jason Porter
http://en.gravatar.com/lightguardjp

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228p231.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

... [show rest of quote]

--

Dan Allen | http://google.com/profiles/dan.j.allen

---

If you reply to this email, your message will be added to the discussion below:

http://discuss.asciidoctor.org/JavaDoc-for-the-Asciidoctor-Java-libraries-tp228p233.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML