You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@spark.apache.org by "Hyukjin Kwon (Jira)" <ji...@apache.org> on 2021/07/09 01:06:00 UTC
[jira] [Resolved] (SPARK-36051) Remove automatic update of
documentation build in the guides
[ https://issues.apache.org/jira/browse/SPARK-36051?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Hyukjin Kwon resolved SPARK-36051.
----------------------------------
Fix Version/s: 3.2.0
Resolution: Fixed
Issue resolved by pull request 33266
[https://github.com/apache/spark/pull/33266]
> Remove automatic update of documentation build in the guides
> ------------------------------------------------------------
>
> Key: SPARK-36051
> URL: https://issues.apache.org/jira/browse/SPARK-36051
> Project: Spark
> Issue Type: Improvement
> Components: docs, PySpark
> Affects Versions: 3.2.0
> Reporter: Hyukjin Kwon
> Assignee: Hyukjin Kwon
> Priority: Trivial
> Fix For: 3.2.0
>
>
> At https://github.com/apache/spark/tree/master/docs#automatically-rebuilding-api-docs,
> {code}
> cd "$SPARK_HOME/python/docs"
> find .. -type f -name '*.py' \
> | entr -s 'make html && cp -r _build/html/. ../../docs/api/python'
> {code}
> is documented. However, this doesn't work very well:
> 1. It doesn't detect the changes in .rst files. But PySpark internally generates rst files so we can't just simply include it in the detection. Otherwise, it goes to an infinite loop
> 2. During PySpark documentation generation, it launches some jobs to generate plot images now. This is broken with {{entr}} command, and the job fails. Seems like it's related to how {{entr}} creates the process internally.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@spark.apache.org
For additional commands, e-mail: issues-help@spark.apache.org