You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hudi.apache.org by "rangareddy (via GitHub)" <gi...@apache.org> on 2025/11/24 07:22:44 UTC

[PR] docs: Rearrange the Bundle entries in download page and set Scala 2.13 as default version in spark quick start guide [hudi]

rangareddy opened a new pull request, #14336:
URL: https://github.com/apache/hudi/pull/14336

   ### Describe the issue this Pull Request addresses
   
   This PR addresses two primary documentation and usability issues:
   
   **Prioritization on the Download Page:** The order of Hudi bundle entries on the download page needed rearrangement to prioritize the most commonly used and recommended versions/bundles, improving user experience and discovery.
   
   **Modernizing Default Quick Start Stack:** The default Scala version referenced in the Spark Quick Start Guide was outdated. We are updating the guide to default to Scala 2.13, aligning with modern Spark distributions and best practices for new users, minimizing potential dependency conflicts.
   
   <!-- Either describe the issue inline here with motivation behind the changes 
        (or) link to an issue by including `Closes #<issue-number>` for context. 
        If this PR includes changes to the storage format, public APIs,
        or has breaking changes, use `!` (e.g., feat!: ...) -->
   
   ### Summary and Changelog
   
   This PR improves the Hudi documentation for better clarity and alignment with current technology standards.
   
   **Summary:** The download page bundles have been reordered for better user flow, and the Spark Quick Start Guide now uses Scala 2.13 as the default build version.
   
   **Changelog:**
   
   * Modified the configuration or underlying data of the Hudi website's download page to rearrange the listing order of the available bundle artifacts.
   * Updated the Spark Quick Start Guide documentation:
   
   <!-- Short, plain-English summary of what users gain or what changed in behavior.
        Followed by a detailed log of all the changes. Highlight if any code was copied. -->
   
   ### Impact
   
   This change is purely a documentation and configuration update with no impact on core Hudi functionality.
   <!-- Describe any public API or user-facing feature change or any performance impact. -->
   
   ### Risk Level
   
   none
   
   <!-- Accepted values: none, low, medium or high. Other than `none`, explain the risk.
        If medium or high, explain what verification was done to mitigate the risks. -->
   
   ### Documentation Update
   
   The following documentation elements have been updated:
   * **Download Page:** The manifest/configuration that defines the order of bundles on the Hudi website's download page has been updated to reflect the new prioritization.
   * **Spark Quick Start Guide:** All setup instructions, environment variable definitions, and command examples are revised to specify SCALA_VERSION=2.13 as the default.
   
   <!-- Describe any necessary documentation update if there is any new feature, config, or user-facing change. If not, put "none".
   
   - The config description must be updated if new configs are added or the default value of the configs are changed.
   - Any new feature or user-facing change requires updating the Hudi website. Please follow the 
     [instruction](https://hudi.apache.org/contribute/developer-setup#website) to make changes to the website. -->
   
   ### Contributor's checklist
   
   - [x] Read through [contributor's guide](https://hudi.apache.org/contribute/how-to-contribute)
   - [x] Enough context is provided in the sections above
   - [x] Adequate tests were added if applicable
   


-- 
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: commits-unsubscribe@hudi.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] docs: Rearrange the Bundle entries in download page and set Scala 2.13 as default version in spark quick start guide [hudi]

Posted by "rangareddy (via GitHub)" <gi...@apache.org>.
rangareddy commented on code in PR #14336:
URL: https://github.com/apache/hudi/pull/14336#discussion_r2556802607


##########
website/docs/quick-start-guide.md:
##########
@@ -95,7 +95,7 @@ From the extracted directory run Spark SQL with Hudi:
 export SPARK_VERSION=3.5
 export HUDI_VERSION=1.1.0
 # For Scala versions: 2.12/2.13
-export SCALA_VERSION=2.12
+export SCALA_VERSION=2.13

Review Comment:
   I will raise a new pr for 1.1 versioned docs



-- 
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: commits-unsubscribe@hudi.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] docs: Rearrange the Bundle entries in download page and set Scala 2.13 as default version in spark quick start guide [hudi]

Posted by "rangareddy (via GitHub)" <gi...@apache.org>.
rangareddy commented on code in PR #14336:
URL: https://github.com/apache/hudi/pull/14336#discussion_r2556802607


##########
website/docs/quick-start-guide.md:
##########
@@ -95,7 +95,7 @@ From the extracted directory run Spark SQL with Hudi:
 export SPARK_VERSION=3.5
 export HUDI_VERSION=1.1.0
 # For Scala versions: 2.12/2.13
-export SCALA_VERSION=2.12
+export SCALA_VERSION=2.13

Review Comment:
   I will raise a new pr for 1.1 versioned docs



-- 
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: commits-unsubscribe@hudi.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] docs: Rearrange the Bundle entries in download page and set Scala 2.13 as default version in spark quick start guide [hudi]

Posted by "xushiyan (via GitHub)" <gi...@apache.org>.
xushiyan commented on code in PR #14336:
URL: https://github.com/apache/hudi/pull/14336#discussion_r2556788315


##########
website/docs/quick-start-guide.md:
##########
@@ -95,7 +95,7 @@ From the extracted directory run Spark SQL with Hudi:
 export SPARK_VERSION=3.5
 export HUDI_VERSION=1.1.0
 # For Scala versions: 2.12/2.13
-export SCALA_VERSION=2.12
+export SCALA_VERSION=2.13

Review Comment:
   can you apply the quick start changes to 1.1 versioned docs too? the website has already cut off the version



-- 
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: commits-unsubscribe@hudi.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] docs: Rearrange the Bundle entries in download page and set Scala 2.13 as default version in spark quick start guide [hudi]

Posted by "rangareddy (via GitHub)" <gi...@apache.org>.
rangareddy closed pull request #14336: docs: Rearrange the Bundle entries in download page and set Scala 2.13 as default version in spark quick start guide
URL: https://github.com/apache/hudi/pull/14336


-- 
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: commits-unsubscribe@hudi.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


Re: [PR] docs: Rearrange the Bundle entries in download page and set Scala 2.13 as default version in spark quick start guide [hudi]

Posted by "rangareddy (via GitHub)" <gi...@apache.org>.
rangareddy commented on PR #14336:
URL: https://github.com/apache/hudi/pull/14336#issuecomment-3571601033

   Raised another PR so closing the PR https://github.com/apache/hudi/pull/14342


-- 
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: commits-unsubscribe@hudi.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org