dongjoon-hyun opened a new pull request #29017:
URL: https://github.com/apache/spark/pull/29017


   ### What changes were proposed in this pull request?
   
   This PR aims to disable SBT unidoc generation testing in Jenkins environment 
because it's not used for the official documentation generation.
   
   ### Why are the changes needed?
   
   Apache Spark `release-build.sh` generates the official document by using the 
following command.
   - 
https://github.com/apache/spark/blob/master/dev/create-release/release-build.sh#L341
   
   ```bash
   echo "Building Spark docs"
   cd docs
   # TODO: Make configurable to add this: PRODUCTION=1
   PRODUCTION=1 RELEASE_VERSION="$SPARK_VERSION" jekyll build
   ```
   
   And, this is executed by the following `unidoc` command for Scala/Java API 
doc.
   - 
https://github.com/apache/spark/blob/master/docs/_plugins/copy_api_dirs.rb#L30
   
   ```ruby
   puts "Running 'build/sbt -Pkinesis-asl clean compile unidoc' from " + pwd + 
"; this may take a few minutes..."
   system("build/sbt -Pkinesis-asl clean compile unidoc") || raise("Unidoc 
generation failed")
   ```
   
   However, the PR builder has a different test coverage like the following.
   ```
   Building Unidoc API Documentation
   ========================================================================
   [info] Building Spark unidoc using SBT with these arguments:  -Phadoop-3.2 
-Phive-2.3 -Pspark-ganglia-lgpl -Pkubernetes -Pmesos -Phadoop-cloud -Phive 
-Phive-thriftserver -Pkinesis-asl -Pyarn unidoc
   ```
   
   ### Does this PR introduce _any_ user-facing change?
   
   No. (This is used only for testing and not used in the official doc 
generation.)
   
   ### How was this patch tested?
   
   Pass the Jenkins without doc generation invocation.


----------------------------------------------------------------
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]



---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to