[ 
https://issues.apache.org/jira/browse/HTRACE-367?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15273132#comment-15273132
 ] 

Lewis John McGibbney commented on HTRACE-367:
---------------------------------------------

bq. I assume you've seen the JavaDocs for htrace-core4 available at 
http://htrace.incubator.apache.org/javadoc/4.1/htrace-core/index.html ?
Yes, thats when I realized that there was no way to quickly see what methods 
were available in other Classes outside of the core module.

bq. This should be very helpful for people integrating HTrace into 
applications, since the htrace-core4 API is the one they need to use.
Agreed, however the utopian vision is for ever user to be a developer as well 
right??? It costs very little to provide dev-level aggregate Javadoc's for devs 
to get stuck in to.

bq. When you say aggregate JavaDoc, you mean the JavaDoc for all subprojects 
combined?
Yes, the result of executing mvn javadoc:aggregate from $HTRACE_HOME

bq. That would certainly be helpful for people developing HTrace itself, 
although not for outside users.
Correct... that's a very important point.

> Publish Aggrgate Javadocs
> -------------------------
>
>                 Key: HTRACE-367
>                 URL: https://issues.apache.org/jira/browse/HTRACE-367
>             Project: HTrace
>          Issue Type: Improvement
>          Components: docs
>            Reporter: Lewis John McGibbney
>            Priority: Minor
>
> Right now, one is required to download source and manually build the full 
> Javadoc e.g. mvn javadoc;aggregate in order to see aggregate, full Javadoc 
> for HTrace.
> We should simply provide this over on 
> http://htrace.incubator.apache.org/#javadoc
> Can someone please generate the full Javadoc and commit it to SVN r wherever 
> the HTrace site is published from? Thanks in advance.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Reply via email to