[
https://issues.apache.org/jira/browse/BEAM-9219?focusedWorklogId=381036&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-381036
]
ASF GitHub Bot logged work on BEAM-9219:
----------------------------------------
Author: ASF GitHub Bot
Created on: 03/Feb/20 15:36
Start Date: 03/Feb/20 15:36
Worklog Time Spent: 10m
Work Description: soyrice commented on pull request #10745: [BEAM-9219]
Streamline creation of Python and Java dependencies pages
URL: https://github.com/apache/beam/pull/10745#discussion_r374167609
##########
File path: website/src/documentation/sdks/python-dependencies.md
##########
@@ -26,460 +26,8 @@ behavior in the service. If you are using any of these
packages in your code, be
aware that some libraries are not forward-compatible and you may need to pin to
the listed versions that will be in scope during execution.
-<p>To see the compile and runtime dependencies for your Beam SDK version,
expand
-the relevant section below.</p>
+To see the compile and runtime dependencies for your Beam SDK version, core
SDK dependencies are listed in
`https://raw.githubusercontent.com/apache/beam/v<version_number>/sdks/python/setup.py`
under `REQUIRED_PACKAGES`.
-<details><summary markdown="span"><b>2.17.0</b></summary>
+If you installed any [extra features]({{ site.baseurl
}}/get-started/quickstart-py#extra-requirements) along with `apache-beam`, such
as `gcp` or `test`, you should review the lists under `REQUIRED_TEST_PACKAGES`,
`GCP_REQUIREMENTS`, or `INTERACTIVE_BEAM` for additional dependencies.
Review comment:
s/"you can"/w/"you should" since you don't really have to review the lists
even if you installed the extra features
Also, do we have links to the
REQUIRED_TEST_PACKAGES/GCP_REQUIREMENTS/INTERACTIVE_BEAM lists?
----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
Issue Time Tracking
-------------------
Worklog Id: (was: 381036)
Time Spent: 0.5h (was: 20m)
> Streamline creation of Python and Java dependencies pages
> ---------------------------------------------------------
>
> Key: BEAM-9219
> URL: https://issues.apache.org/jira/browse/BEAM-9219
> Project: Beam
> Issue Type: Improvement
> Components: website
> Reporter: David Wrede
> Priority: Minor
> Time Spent: 0.5h
> Remaining Estimate: 0h
>
> This issue is about the need to address keeping both Python and Java SDK
> dependency pages more relevant and up-to-date while reducing the amount of
> time it takes to provide that information. The current method of scraping and
> copying dependencies into a table for every release is a non-trivial task
> because of the semi-automated workflows done by the tech writers on the
> website.
> In an effort to provide accurate dependency listings that are always in sync
> with SDK releases, referring people to the appropriate places in the source
> code (or through CLI commands) should provide people the information they are
> looking for and not require the creation and maintenance of an automated
> tooling solution to generate the dependency tables.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
