Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [cross-project-issues-dev] Publishing Javadoc - How To?

On Fri, Sep 26, 2014 at 2:05 PM, Matthias Sohn <matthias.sohn@xxxxxxxxx> wrote:
On Fri, Sep 26, 2014 at 11:56 AM, Jeremie Bresson <Jeremie.Bresson@xxxxxxxxx> wrote:

Hi Everybody,

 

Since a very long time people are asking us to publish the Javadoc of the Eclipse Scout Project as HTML page [Bug 408052 - #1].

 

I wonder what the best practice is. I have seen that some project have decided to publish it under:

* help.eclipse.org (for example the SWT project [#2])

* download.eclipse.org (for example the EMF project [#3])

 

Personally I like the second approach. Is there an official recommended approach?

 

Could you also indicate how to achieve this during a CBI build?

We are using maven tycho. I imagine there are examples in the projects that are already publishing Javadoc. I would really appreciate a pointer to know how to start.

 

Thank you in advance,

Jérémie

[#1] https://bugs.eclipse.org/bugs/show_bug.cgi?id=408052

[#2] http://help.eclipse.org/luna/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/swt/package-summary.html

[#3] http://download.eclipse.org/modeling/emf/emf/javadoc/2.9.0/


I just implemented the second approach for JGit using maven-site-plugin, the changes implementing
that are here:
and the first result is here (javadoc is under project reports)


Back to the top