[
https://issues.apache.org/jira/browse/BEAM-4510?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17123315#comment-17123315
]
Beam JIRA Bot commented on BEAM-4510:
-------------------------------------
This issue is P2 but has been unassigned without any comment for 60 days so it
has been labeled "stale-P2". If this issue is still affecting you, we care!
Please comment and remove the label. Otherwise, in 14 days the issue will be
moved to P3.
Please see https://beam.apache.org/contribute/jira-priorities/ for a detailed
explanation of what these priorities mean.
> Release-based Javadocs and Pydocs should be generated during the website build
> ------------------------------------------------------------------------------
>
> Key: BEAM-4510
> URL: https://issues.apache.org/jira/browse/BEAM-4510
> Project: Beam
> Issue Type: Improvement
> Components: website
> Reporter: Scott Wegner
> Priority: P2
> Labels: stale-P2
>
> Currently, Javadocs and Pydocs are generated manually as a [step during the
> release
> process|https://beam.apache.org/contribute/release-guide/#propose-a-pull-request-for-website-updates]
> and [checked
> into|https://github.com/apache/beam-site/tree/asf-site/src/documentation/sdks]
> the apache/beam-site repository. The [Beam-Site Automation
> Reliability|https://s.apache.org/beam-site-automation] project proposes a set
> of work to migrate the website sources into the apache/beam repository, but
> doesn't address changes to the process for generating Javadocs / Pydocs.
> It would be nice if the API documentation could also generated as part of the
> website HTML generation process, such that it automatically stays up-to-date
> and removes a manual step from the release process.
> This is following up on
> [discussion|https://docs.google.com/a/google.com/document/d/1lfbMhdIyDzIaBTgc9OUByhSwR94kfOzS_ozwKWTVl5U/edit?disco=AAAAB50kLV4]
> from the [Beam-Site Automation
> Reliability|https://s.apache.org/beam-site-automation] project design.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
