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

Davor Bonaci commented on BEAM-1175:
------------------------------------

I believe we have recently removed runner-facing Javadoc from being published 
for each release. Now, the published Javadoc should include only user facing 
things. (To became visible with the next release). I think this addresses the 
first part of this issue.

The second part is about making runner-facing Javadoc published. That is 
available on a per-module basis in Maven Central, and automatically integrated 
into some tooling. Not sure we need to publish it on the website just yet.

So, 1/2 is done, the other half can be deferred, I think. Resolving. Perhaps 
reopen if you think we need to address this in the near future.

> Separate runners-core Javadoc from SDK Javadoc, and perhaps other artifacts
> ---------------------------------------------------------------------------
>
>                 Key: BEAM-1175
>                 URL: https://issues.apache.org/jira/browse/BEAM-1175
>             Project: Beam
>          Issue Type: Bug
>          Components: website
>            Reporter: Kenneth Knowles
>            Assignee: James Malone
>             Fix For: Not applicable
>
>
> Currently, the runners-core Javadoc is included with the SDK's Javadoc on the 
> website.
> Pipeline authors should only be viewing the SDK's Javadoc, and likely the IOs.
> Generally, while I do think we can't really separate every IO Javadoc, it is 
> extremely confusing to have Javadoc for separate POM dependencies included 
> together, since the classes listed will not actually be available to someone 
> who just depends on the SDK.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)

Reply via email to