nchammas opened a new pull request, #44791:
URL: https://github.com/apache/spark/pull/44791

   ### What changes were proposed in this pull request?
   
   We are abusing Jekyll's plugin system to set flags for what API docs to 
build. This change maintains this overall status quo but makes the following 
improvements:
   
   - Rename the plugin file to be in line with its actual purpose.
   - Organize the code into functions so it's easier to follow and understand.
   - Print section headers that are easier to find in the output when building 
the docs.
   
   ### Why are the changes needed?
   
   This should make maintaining this part of the doc building workflow easier.
   
   ### Does this PR introduce _any_ user-facing change?
   
   No.
   
   ### How was this patch tested?
   
   I built the docs with various skip flags set and confirmed the build 
succeeds. I also manually browsed through some of the Scala, Java, Python, and 
SQL API docs.
   
   The only docs I didn't test building were the R docs, because I do not have 
R installed locally.
   
   Here is the build output on my machine for `SKIP_RDOC=1`: 
[build-docs.log.zip](https://github.com/apache/spark/files/13983386/build-docs.log.zip)
   
   ### Was this patch authored or co-authored using generative AI tooling?
   
   No.


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

To unsubscribe, e-mail: [email protected]

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