This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/datafusion-comet.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 96ecb1126 Publish built docs triggered by
ea26629049aa3e748e16eb6170793f2ecde045be
96ecb1126 is described below
commit 96ecb11262a3cd2cd6ce924942e522928961dd57
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Wed Jan 21 18:49:02 2026 +0000
Publish built docs triggered by ea26629049aa3e748e16eb6170793f2ecde045be
---
_sources/contributor-guide/development.md.txt | 21 ++++++++++++++++++++-
contributor-guide/development.html | 19 ++++++++++++++++++-
searchindex.js | 2 +-
3 files changed, 39 insertions(+), 3 deletions(-)
diff --git a/_sources/contributor-guide/development.md.txt
b/_sources/contributor-guide/development.md.txt
index 4d6bbe9f2..ec6231617 100644
--- a/_sources/contributor-guide/development.md.txt
+++ b/_sources/contributor-guide/development.md.txt
@@ -160,7 +160,26 @@ Other options for selecting specific suites are described
in the [ScalaTest Mave
## Plan Stability Testing
Comet has a plan stability testing framework that can be used to test the
stability of the query plans generated by Comet.
-The plan stability testing framework is located in the `spark` module and can
be run using the following commands.
+The plan stability testing framework is located in the `spark` module.
+
+### Using the Helper Script
+
+The easiest way to regenerate golden files is to use the provided script:
+
+```sh
+# Regenerate golden files for all Spark versions
+./dev/regenerate-golden-files.sh
+
+# Regenerate only for a specific Spark version
+./dev/regenerate-golden-files.sh --spark-version 3.5
+```
+
+The script verifies that JDK 17+ is configured (required for Spark 4.0),
installs Comet for each
+Spark version, and runs the plan stability tests with
`SPARK_GENERATE_GOLDEN_FILES=1`.
+
+### Manual Instructions
+
+Alternatively, you can run the tests manually using the following commands.
First, Comet needs to be installed for each Spark version to be tested:
diff --git a/contributor-guide/development.html
b/contributor-guide/development.html
index affd588ff..11d637888 100644
--- a/contributor-guide/development.html
+++ b/contributor-guide/development.html
@@ -591,7 +591,23 @@ in their name in <code class="docutils literal
notranslate"><span class="pre">or
<section id="plan-stability-testing">
<h2>Plan Stability Testing<a class="headerlink" href="#plan-stability-testing"
title="Link to this heading">#</a></h2>
<p>Comet has a plan stability testing framework that can be used to test the
stability of the query plans generated by Comet.
-The plan stability testing framework is located in the <code class="docutils
literal notranslate"><span class="pre">spark</span></code> module and can be
run using the following commands.</p>
+The plan stability testing framework is located in the <code class="docutils
literal notranslate"><span class="pre">spark</span></code> module.</p>
+<section id="using-the-helper-script">
+<h3>Using the Helper Script<a class="headerlink"
href="#using-the-helper-script" title="Link to this heading">#</a></h3>
+<p>The easiest way to regenerate golden files is to use the provided
script:</p>
+<div class="highlight-sh notranslate"><div
class="highlight"><pre><span></span><span class="c1"># Regenerate golden files
for all Spark versions</span>
+./dev/regenerate-golden-files.sh
+
+<span class="c1"># Regenerate only for a specific Spark version</span>
+./dev/regenerate-golden-files.sh<span class="w"> </span>--spark-version<span
class="w"> </span><span class="m">3</span>.5
+</pre></div>
+</div>
+<p>The script verifies that JDK 17+ is configured (required for Spark 4.0),
installs Comet for each
+Spark version, and runs the plan stability tests with <code class="docutils
literal notranslate"><span
class="pre">SPARK_GENERATE_GOLDEN_FILES=1</span></code>.</p>
+</section>
+<section id="manual-instructions">
+<h3>Manual Instructions<a class="headerlink" href="#manual-instructions"
title="Link to this heading">#</a></h3>
+<p>Alternatively, you can run the tests manually using the following
commands.</p>
<p>First, Comet needs to be installed for each Spark version to be tested:</p>
<div class="highlight-sh notranslate"><div
class="highlight"><pre><span></span>./mvnw<span class="w"> </span>install<span
class="w"> </span>-DskipTests<span class="w"> </span>-Pspark-3.4
./mvnw<span class="w"> </span>install<span class="w"> </span>-DskipTests<span
class="w"> </span>-Pspark-3.5
@@ -630,6 +646,7 @@ To regenerate the golden files, you can run the following
commands.</p>
</pre></div>
</div>
</section>
+</section>
<section id="benchmark">
<h2>Benchmark<a class="headerlink" href="#benchmark" title="Link to this
heading">#</a></h2>
<p>There’s a <code class="docutils literal notranslate"><span
class="pre">make</span></code> command to run micro benchmarks in the repo. For
diff --git a/searchindex.js b/searchindex.js
index f1bffec3b..79c499321 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles": {"1. Format Your Code": [[12,
"format-your-code"]], "1. Install Comet": [[21, "install-comet"]], "1. Native
Operators (nativeExecs map)": [[4, "native-operators-nativeexecs-map"]], "2.
Build and Verify": [[12, "build-and-verify"]], "2. Clone Spark and Apply Diff":
[[21, "clone-spark-and-apply-diff"]], "2. Sink Operators (sinks map)": [[4,
"sink-operators-sinks-map"]], "3. Comet JVM Operators": [[4,
"comet-jvm-operators"]], "3. Run Clippy (Recommended)": [[12 [...]
\ No newline at end of file
+Search.setIndex({"alltitles": {"1. Format Your Code": [[12,
"format-your-code"]], "1. Install Comet": [[21, "install-comet"]], "1. Native
Operators (nativeExecs map)": [[4, "native-operators-nativeexecs-map"]], "2.
Build and Verify": [[12, "build-and-verify"]], "2. Clone Spark and Apply Diff":
[[21, "clone-spark-and-apply-diff"]], "2. Sink Operators (sinks map)": [[4,
"sink-operators-sinks-map"]], "3. Comet JVM Operators": [[4,
"comet-jvm-operators"]], "3. Run Clippy (Recommended)": [[12 [...]
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
