This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/datafusion-ballista.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 1c5f5a9a4 Publish built docs triggered by
acede27396fa73fc690c5aa77fb40f82ce838871
1c5f5a9a4 is described below
commit 1c5f5a9a4e412f739709af2e9f0a7a4864ce2b23
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Sun Jul 12 16:51:34 2026 +0000
Publish built docs triggered by acede27396fa73fc690c5aa77fb40f82ce838871
---
_sources/contributors-guide/user-personas.md.txt | 148 +++++++++++++++
_sources/index.rst.txt | 1 +
changelog/0.10.0.html | 1 +
changelog/0.11.0.html | 1 +
changelog/0.12.0.html | 1 +
changelog/0.5.0.html | 1 +
changelog/0.6.0.html | 1 +
changelog/0.7.0.html | 1 +
changelog/0.8.0.html | 1 +
changelog/0.9.0.html | 1 +
changelog/43.0.0.html | 1 +
changelog/44.0.0.html | 1 +
changelog/45.0.0.html | 1 +
changelog/46.0.0.html | 1 +
changelog/47.0.0.html | 1 +
changelog/48.0.0.html | 1 +
changelog/49.0.0.html | 1 +
changelog/50.0.0.html | 1 +
changelog/51.0.0.html | 1 +
changelog/52.0.0.html | 1 +
changelog/53.0.0.html | 1 +
changelog/index.html | 1 +
community/communication.html | 1 +
contributors-guide/architecture.html | 1 +
contributors-guide/code-organization.html | 7 +-
contributors-guide/development.html | 7 +-
.../{code-organization.html => user-personas.html} | 200 ++++++++++++++++-----
genindex.html | 1 +
index.html | 2 +
objects.inv | Bin 1112 -> 1133 bytes
search.html | 1 +
searchindex.js | 2 +-
upgrading/54.0.0.html | 1 +
upgrading/index.html | 1 +
user-guide/cli.html | 1 +
user-guide/configs.html | 1 +
user-guide/deployment/cargo-install.html | 1 +
user-guide/deployment/docker-compose.html | 1 +
user-guide/deployment/docker.html | 1 +
user-guide/deployment/index.html | 1 +
user-guide/deployment/kubernetes.html | 1 +
user-guide/deployment/quick-start.html | 1 +
user-guide/extending-components.html | 1 +
user-guide/extensions-example.html | 1 +
user-guide/faq.html | 1 +
user-guide/introduction.html | 1 +
user-guide/metrics.html | 1 +
user-guide/python/cloud-storage.html | 1 +
user-guide/python/index.html | 1 +
user-guide/python/jupyter.html | 1 +
user-guide/python/quickstart.html | 1 +
user-guide/rust.html | 1 +
user-guide/scheduler.html | 1 +
user-guide/spark-compatible-functions.html | 1 +
user-guide/tuning-guide.html | 1 +
55 files changed, 361 insertions(+), 53 deletions(-)
diff --git a/_sources/contributors-guide/user-personas.md.txt
b/_sources/contributors-guide/user-personas.md.txt
new file mode 100644
index 000000000..a54d03854
--- /dev/null
+++ b/_sources/contributors-guide/user-personas.md.txt
@@ -0,0 +1,148 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# User Personas
+
+Ballista serves several distinct audiences, each of which comes to the project
+for a different reason and depends on a different set of capabilities. This
page
+names those audiences as **personas** and, for each one, records the guarantees
+that audience relies on.
+
+## Why this page exists
+
+This is a review contract, not marketing copy. It exists so that changes to
+Ballista stay **additive**:
+
+- A pull request may **add** a new persona, or **extend** an existing one with
+ new capabilities.
+- A pull request must **not remove or silently regress** a capability that an
+ existing persona depends on.
+
+Reviewers evaluate every non-trivial pull request against this list. Each
+persona lists concrete "red flags" — the kinds of change that would quietly
take
+functionality away from that audience. A red flag does not mean a change is
+forbidden, but it does mean the change needs explicit discussion and maintainer
+sign-off, and usually a migration path (for example an entry in the
+[upgrade guide](../upgrading/index)), rather than landing silently.
+
+These personas are deliberately in tension with one another. One audience wants
+distributed execution to be a transparent implementation detail; another wants
+the execution model exposed and tunable; another wants Ballista's internals to
+be a stable, composable library. The point of keeping them all written down is
+to make sure a change that delights one audience does not quietly break
another.
+
+## Persona 1: The DataFusion user going multi-node
+
+- **Who**: A data engineer or analyst already using
+ [DataFusion](https://datafusion.apache.org/) single-process (often through
the
+ Python bindings) who has outgrown a single machine.
+- **Coming from**: DataFusion, single process.
+- **Why Ballista**: Run the same SQL and DataFrame workloads across a cluster
+ with minimal code change and _identical results_.
+- **Depends on** (must not regress):
+ - Query results and semantics match single-process DataFusion for the same
+ input.
+ - A client surface that mirrors DataFusion's `SessionContext` / DataFrame /
SQL
+ API.
+ - `datafusion.*` session configuration overrides are honored end-to-end, so
+ users tune DataFusion the way they already do.
+ - Standard object stores and file formats work and produce correct results
+ across partitions.
+ - Distributed execution is _transparent_: getting a correct answer never
+ requires the user to reason about stages, tasks, or partitioning.
+- **Red flags in a pull request**:
+ - Results diverge from single-process DataFusion for the same input.
+ - `datafusion.*` overrides are dropped or ignored during scheduling/planning.
+ - A DataFusion feature that is correct single-node becomes silently wrong
when
+ the plan is split across stages (for example dynamic filter pushdown,
+ uncorrelated scalar subqueries, or a scan reading more than its assigned
+ partition).
+ - Client API changes that break the DataFusion-mirroring surface.
+
+## Persona 2: The Spark user wanting the same execution model
+
+- **Who**: A data engineer or platform owner running Spark SQL / batch jobs who
+ wants a lighter, Rust-native alternative without relearning a new execution
+ paradigm.
+- **Coming from**: Apache Spark.
+- **Why Ballista**: Keep the Spark mental model — plans split into **stages**
at
+ shuffle boundaries, one **task** per partition, shuffle files, executors with
+ task slots, and adaptive query execution (**AQE**) for runtime adaptivity —
on
+ top of DataFusion and Arrow.
+- **Depends on** (must not regress):
+ - The stage/task execution model at shuffle boundaries.
+ - The AQE / adaptive planner path (partition coalescing, dynamic join
+ selection, runtime broadcast), available and gated behind configuration.
+ - Broadcast joins for small build sides, to avoid shuffles and skew (the
+ equivalent of Spark's broadcast hash join).
+ - The operational surface Spark users expect: a scheduler plus executors,
+ task-slot concurrency, a tunable `target_partitions`, and stage/task
+ observability (task timings, a history server / UI) for debugging skew.
+ - Behavior driven by configuration and `SET`, not hard-coded planner choices.
+- **Red flags in a pull request**:
+ - Removing or short-circuiting the stage/task boundary model, or collapsing
+ toward single-process execution.
+ - Regressing or removing the AQE / adaptive planner path — or making it the
+ only path in a way that breaks Persona 1's transparent static path.
+ - Hard-coding a join or planner strategy instead of gating it behind
+ configuration.
+ - Removing the stage/task observability that Spark users rely on to diagnose
+ skew.
+
+## Persona 3: The library user building a specialized engine
+
+- **Who**: An engineer using Ballista as a _framework_ — the foundation for a
+ specialized or bespoke distributed query engine — rather than as a turnkey
+ cluster.
+- **Coming from**: Building on DataFusion as a library, now needing
distribution
+ (or replacing a hand-rolled distributed layer).
+- **Why Ballista**: Reusable scheduler, executor, and plan-serialization
+ building blocks with extension points, instead of writing distributed
+ execution from scratch.
+- **Depends on** (must not regress):
+ - Stable, composable public APIs across the `scheduler`, `executor`,
`client`,
+ and `core` crates (the execution graph and plan serialization included).
+ - Extension points that do not require forking: custom object stores,
+ physical/logical extension codecs, custom operators and functions, a
+ pluggable runtime producer, custom session configuration, and a custom
query
+ planner.
+ - Behavior that stays _configurable rather than hard-coded_, so an embedder
can
+ swap the planner, join strategy, partitioning, or runtime environment.
+ - Backward-compatible public APIs, with breaking changes signaled in the
+ [upgrade guide](../upgrading/index).
+ - No assumptions baked into the core that only fit the built-in clients or
the
+ TPC-H benchmark.
+- **Red flags in a pull request**:
+ - Breaking a public API signature without an upgrade-guide entry.
+ - Hard-coding behavior that used to be pluggable, or removing an extension
+ point (an extension-codec argument, the runtime-producer override,
+ session-config injection).
+ - Coupling core logic to a specific client, planner, or benchmark instead of
+ keeping it behind a trait or configuration.
+ - Wire-format or serialization changes that break externally-produced plans
+ with no compatibility path.
+
+## Adding a persona
+
+This registry is append-only. As Ballista attracts new kinds of users, add a
+persona for each one via a pull request, using the same schema (who they are,
+what they are coming from, why Ballista, what they depend on, and the red flags
+that would regress them). Do not remove existing personas: an audience that
+relied on Ballista does not stop existing because our priorities shifted, and
+the whole value of this page is that the guarantees only accumulate.
diff --git a/_sources/index.rst.txt b/_sources/index.rst.txt
index e66e23752..c208c29ec 100644
--- a/_sources/index.rst.txt
+++ b/_sources/index.rst.txt
@@ -78,6 +78,7 @@ Table of content
contributors-guide/architecture
contributors-guide/code-organization
+ contributors-guide/user-personas
contributors-guide/development
Source code <https://github.com/apache/datafusion-ballista/>
diff --git a/changelog/0.10.0.html b/changelog/0.10.0.html
index 3b722bea8..a7c70e46a 100644
--- a/changelog/0.10.0.html
+++ b/changelog/0.10.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/0.11.0.html b/changelog/0.11.0.html
index 52588dff7..b7e0c48bc 100644
--- a/changelog/0.11.0.html
+++ b/changelog/0.11.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/0.12.0.html b/changelog/0.12.0.html
index fcedeadb1..620974ee6 100644
--- a/changelog/0.12.0.html
+++ b/changelog/0.12.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/0.5.0.html b/changelog/0.5.0.html
index 7b312d50b..517181f44 100644
--- a/changelog/0.5.0.html
+++ b/changelog/0.5.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/0.6.0.html b/changelog/0.6.0.html
index ee639d218..769507160 100644
--- a/changelog/0.6.0.html
+++ b/changelog/0.6.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/0.7.0.html b/changelog/0.7.0.html
index 2b12d2611..5248a6e5f 100644
--- a/changelog/0.7.0.html
+++ b/changelog/0.7.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/0.8.0.html b/changelog/0.8.0.html
index 1b03cbba0..9b02b321f 100644
--- a/changelog/0.8.0.html
+++ b/changelog/0.8.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/0.9.0.html b/changelog/0.9.0.html
index 1eb111756..472f79b8f 100644
--- a/changelog/0.9.0.html
+++ b/changelog/0.9.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/43.0.0.html b/changelog/43.0.0.html
index 12a6445cb..60ede1ac4 100644
--- a/changelog/43.0.0.html
+++ b/changelog/43.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/44.0.0.html b/changelog/44.0.0.html
index f481437f7..89bb8478d 100644
--- a/changelog/44.0.0.html
+++ b/changelog/44.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/45.0.0.html b/changelog/45.0.0.html
index 377675714..7c33c6cc9 100644
--- a/changelog/45.0.0.html
+++ b/changelog/45.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/46.0.0.html b/changelog/46.0.0.html
index eb6c0c808..e49fff825 100644
--- a/changelog/46.0.0.html
+++ b/changelog/46.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/47.0.0.html b/changelog/47.0.0.html
index 1bbc7f9f2..bbbb87d40 100644
--- a/changelog/47.0.0.html
+++ b/changelog/47.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/48.0.0.html b/changelog/48.0.0.html
index b881327bf..92355dfbd 100644
--- a/changelog/48.0.0.html
+++ b/changelog/48.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/49.0.0.html b/changelog/49.0.0.html
index ff4a0db7e..0bacbe1e2 100644
--- a/changelog/49.0.0.html
+++ b/changelog/49.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/50.0.0.html b/changelog/50.0.0.html
index 2bf75277e..bfbfbe81f 100644
--- a/changelog/50.0.0.html
+++ b/changelog/50.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/51.0.0.html b/changelog/51.0.0.html
index eba0aff37..330324c53 100644
--- a/changelog/51.0.0.html
+++ b/changelog/51.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/52.0.0.html b/changelog/52.0.0.html
index 352dbedba..0b22fa5ff 100644
--- a/changelog/52.0.0.html
+++ b/changelog/52.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/53.0.0.html b/changelog/53.0.0.html
index 5f9257f49..e5dcaad75 100644
--- a/changelog/53.0.0.html
+++ b/changelog/53.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/changelog/index.html b/changelog/index.html
index 3ad749a05..2e362a554 100644
--- a/changelog/index.html
+++ b/changelog/index.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/community/communication.html b/community/communication.html
index 9e6e3a65b..e2f8a3e9c 100644
--- a/community/communication.html
+++ b/community/communication.html
@@ -299,6 +299,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/contributors-guide/architecture.html
b/contributors-guide/architecture.html
index 9027a56dd..a93b71168 100644
--- a/contributors-guide/architecture.html
+++ b/contributors-guide/architecture.html
@@ -300,6 +300,7 @@
<ul class="current nav bd-sidenav">
<li class="toctree-l1 current active"><a class="current reference internal"
href="#">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="code-organization.html">Ballista Code Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/contributors-guide/code-organization.html
b/contributors-guide/code-organization.html
index ca2963356..0a89e36ba 100644
--- a/contributors-guide/code-organization.html
+++ b/contributors-guide/code-organization.html
@@ -46,7 +46,7 @@
<script>DOCUMENTATION_OPTIONS.search_as_you_type = false;</script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
- <link rel="next" title="Ballista Development" href="development.html" />
+ <link rel="next" title="User Personas" href="user-personas.html" />
<link rel="prev" title="Ballista Architecture" href="architecture.html" />
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<meta name="docsearch:language" content="en"/>
@@ -300,6 +300,7 @@
<ul class="current nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1 current active"><a class="current reference internal"
href="#">Ballista Code Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
@@ -452,11 +453,11 @@
</div>
</a>
<a class="right-next"
- href="development.html"
+ href="user-personas.html"
title="next page">
<div class="prev-next-info">
<p class="prev-next-subtitle">next</p>
- <p class="prev-next-title">Ballista Development</p>
+ <p class="prev-next-title">User Personas</p>
</div>
<i class="fa-solid fa-angle-right"></i>
</a>
diff --git a/contributors-guide/development.html
b/contributors-guide/development.html
index 8189d95a7..eb3cd228a 100644
--- a/contributors-guide/development.html
+++ b/contributors-guide/development.html
@@ -47,7 +47,7 @@
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Communication"
href="../community/communication.html" />
- <link rel="prev" title="Ballista Code Organization"
href="code-organization.html" />
+ <link rel="prev" title="User Personas" href="user-personas.html" />
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<meta name="docsearch:language" content="en"/>
<meta name="docsearch:version" content="" />
@@ -300,6 +300,7 @@
<ul class="current nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="code-organization.html">Ballista Code Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="user-personas.html">User Personas</a></li>
<li class="toctree-l1 current active"><a class="current reference internal"
href="#">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
@@ -551,12 +552,12 @@ complete for the next release.</p>
<div class="prev-next-area">
<a class="left-prev"
- href="code-organization.html"
+ href="user-personas.html"
title="previous page">
<i class="fa-solid fa-angle-left"></i>
<div class="prev-next-info">
<p class="prev-next-subtitle">previous</p>
- <p class="prev-next-title">Ballista Code Organization</p>
+ <p class="prev-next-title">User Personas</p>
</div>
</a>
<a class="right-next"
diff --git a/contributors-guide/code-organization.html
b/contributors-guide/user-personas.html
similarity index 66%
copy from contributors-guide/code-organization.html
copy to contributors-guide/user-personas.html
index ca2963356..24a8d6998 100644
--- a/contributors-guide/code-organization.html
+++ b/contributors-guide/user-personas.html
@@ -8,7 +8,7 @@
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0"
/><meta name="viewport" content="width=device-width, initial-scale=1" />
- <title>Ballista Code Organization — Apache DataFusion Ballista
documentation</title>
+ <title>User Personas — Apache DataFusion Ballista
documentation</title>
@@ -42,12 +42,12 @@
<script src="../_static/documentation_options.js?v=5929fcd5"></script>
<script src="../_static/doctools.js?v=fd6eb6e6"></script>
<script src="../_static/sphinx_highlight.js?v=6ffebe34"></script>
- <script>DOCUMENTATION_OPTIONS.pagename =
'contributors-guide/code-organization';</script>
+ <script>DOCUMENTATION_OPTIONS.pagename =
'contributors-guide/user-personas';</script>
<script>DOCUMENTATION_OPTIONS.search_as_you_type = false;</script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Ballista Development" href="development.html" />
- <link rel="prev" title="Ballista Architecture" href="architecture.html" />
+ <link rel="prev" title="Ballista Code Organization"
href="code-organization.html" />
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<meta name="docsearch:language" content="en"/>
<meta name="docsearch:version" content="" />
@@ -299,7 +299,8 @@
<p aria-level="2" class="caption" role="heading"><span
class="caption-text">Contributors Guide</span></p>
<ul class="current nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="architecture.html">Ballista Architecture</a></li>
-<li class="toctree-l1 current active"><a class="current reference internal"
href="#">Ballista Code Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="code-organization.html">Ballista Code Organization</a></li>
+<li class="toctree-l1 current active"><a class="current reference internal"
href="#">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
@@ -350,7 +351,7 @@
<i class="fa-solid fa-home"></i>
</a>
</li>
- <li class="breadcrumb-item active" aria-current="page"><span
class="ellipsis">Ballista Code Organization</span></li>
+ <li class="breadcrumb-item active" aria-current="page"><span
class="ellipsis">User Personas</span></li>
</ul>
</nav>
</div>
@@ -385,50 +386,157 @@
specific language governing permissions and limitations
under the License.
-->
-<section id="ballista-code-organization">
-<h1>Ballista Code Organization<a class="headerlink"
href="#ballista-code-organization" title="Link to this heading">#</a></h1>
-<p>This section provides links to the source code for major areas of
functionality.</p>
-<section id="ballista-core-crate">
-<h2>ballista-core crate<a class="headerlink" href="#ballista-core-crate"
title="Link to this heading">#</a></h2>
+<section id="user-personas">
+<h1>User Personas<a class="headerlink" href="#user-personas" title="Link to
this heading">#</a></h1>
+<p>Ballista serves several distinct audiences, each of which comes to the
project
+for a different reason and depends on a different set of capabilities. This
page
+names those audiences as <strong>personas</strong> and, for each one, records
the guarantees
+that audience relies on.</p>
+<section id="why-this-page-exists">
+<h2>Why this page exists<a class="headerlink" href="#why-this-page-exists"
title="Link to this heading">#</a></h2>
+<p>This is a review contract, not marketing copy. It exists so that changes to
+Ballista stay <strong>additive</strong>:</p>
<ul class="simple">
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/ballista/core";>Crate
Source</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/ballista/core/proto/ballista.proto";>Protocol
Buffer Definition</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/tree/main/ballista/core/src/execution_plans";>Execution
Plans</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/ballista/core/src/client.rs";>Ballista
Client</a></p></li>
+<li><p>A pull request may <strong>add</strong> a new persona, or
<strong>extend</strong> an existing one with
+new capabilities.</p></li>
+<li><p>A pull request must <strong>not remove or silently regress</strong> a
capability that an
+existing persona depends on.</p></li>
</ul>
+<p>Reviewers evaluate every non-trivial pull request against this list. Each
+persona lists concrete “red flags” — the kinds of change that would quietly
take
+functionality away from that audience. A red flag does not mean a change is
+forbidden, but it does mean the change needs explicit discussion and maintainer
+sign-off, and usually a migration path (for example an entry in the
+<a class="reference internal" href="../upgrading/index.html"><span class="doc
std std-doc">upgrade guide</span></a>), rather than landing silently.</p>
+<p>These personas are deliberately in tension with one another. One audience
wants
+distributed execution to be a transparent implementation detail; another wants
+the execution model exposed and tunable; another wants Ballista’s internals to
+be a stable, composable library. The point of keeping them all written down is
+to make sure a change that delights one audience does not quietly break
another.</p>
</section>
-<section id="ballista-scheduler-crate">
-<h2>ballista-scheduler crate<a class="headerlink"
href="#ballista-scheduler-crate" title="Link to this heading">#</a></h2>
+<section id="persona-1-the-datafusion-user-going-multi-node">
+<h2>Persona 1: The DataFusion user going multi-node<a class="headerlink"
href="#persona-1-the-datafusion-user-going-multi-node" title="Link to this
heading">#</a></h2>
<ul class="simple">
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/tree/main/ballista/scheduler";>Crate
Source</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/ballista/scheduler/src/planner.rs";>Distributed
Query Planner</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/ballista/scheduler/src/scheduler_server/grpc.rs";>gRPC
Service</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/ballista/scheduler/src/flight_sql.rs";>Flight
SQL Service</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/tree/main/ballista/scheduler/src/api";>REST
API</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/ballista/scheduler/src/metrics/prometheus.rs";>Prometheus
Integration</a></p></li>
+<li><p><strong>Who</strong>: A data engineer or analyst already using
+<a class="reference external"
href="https://datafusion.apache.org/";>DataFusion</a> single-process (often
through the
+Python bindings) who has outgrown a single machine.</p></li>
+<li><p><strong>Coming from</strong>: DataFusion, single process.</p></li>
+<li><p><strong>Why Ballista</strong>: Run the same SQL and DataFrame workloads
across a cluster
+with minimal code change and <em>identical results</em>.</p></li>
+<li><p><strong>Depends on</strong> (must not regress):</p>
+<ul>
+<li><p>Query results and semantics match single-process DataFusion for the same
+input.</p></li>
+<li><p>A client surface that mirrors DataFusion’s <code class="docutils
literal notranslate"><span class="pre">SessionContext</span></code> / DataFrame
/ SQL
+API.</p></li>
+<li><p><code class="docutils literal notranslate"><span
class="pre">datafusion.*</span></code> session configuration overrides are
honored end-to-end, so
+users tune DataFusion the way they already do.</p></li>
+<li><p>Standard object stores and file formats work and produce correct results
+across partitions.</p></li>
+<li><p>Distributed execution is <em>transparent</em>: getting a correct answer
never
+requires the user to reason about stages, tasks, or partitioning.</p></li>
</ul>
-</section>
-<section id="ballista-executor-crate">
-<h2>ballista-executor crate<a class="headerlink"
href="#ballista-executor-crate" title="Link to this heading">#</a></h2>
-<ul class="simple">
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/tree/main/ballista/executor";>Crate
Source</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/ballista/executor/src/flight_service.rs";>Flight
Service</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/ballista/executor/src/executor_server.rs";>Executor
Server</a></p></li>
+</li>
+<li><p><strong>Red flags in a pull request</strong>:</p>
+<ul>
+<li><p>Results diverge from single-process DataFusion for the same
input.</p></li>
+<li><p><code class="docutils literal notranslate"><span
class="pre">datafusion.*</span></code> overrides are dropped or ignored during
scheduling/planning.</p></li>
+<li><p>A DataFusion feature that is correct single-node becomes silently wrong
when
+the plan is split across stages (for example dynamic filter pushdown,
+uncorrelated scalar subqueries, or a scan reading more than its assigned
+partition).</p></li>
+<li><p>Client API changes that break the DataFusion-mirroring surface.</p></li>
+</ul>
+</li>
</ul>
</section>
-<section id="ballista-crate">
-<h2>ballista crate<a class="headerlink" href="#ballista-crate" title="Link to
this heading">#</a></h2>
+<section id="persona-2-the-spark-user-wanting-the-same-execution-model">
+<h2>Persona 2: The Spark user wanting the same execution model<a
class="headerlink"
href="#persona-2-the-spark-user-wanting-the-same-execution-model" title="Link
to this heading">#</a></h2>
<ul class="simple">
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/tree/main/ballista/client";>Crate
Source</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/ballista/client/src/context.rs";>Context</a></p></li>
+<li><p><strong>Who</strong>: A data engineer or platform owner running Spark
SQL / batch jobs who
+wants a lighter, Rust-native alternative without relearning a new execution
+paradigm.</p></li>
+<li><p><strong>Coming from</strong>: Apache Spark.</p></li>
+<li><p><strong>Why Ballista</strong>: Keep the Spark mental model — plans
split into <strong>stages</strong> at
+shuffle boundaries, one <strong>task</strong> per partition, shuffle files,
executors with
+task slots, and adaptive query execution (<strong>AQE</strong>) for runtime
adaptivity — on
+top of DataFusion and Arrow.</p></li>
+<li><p><strong>Depends on</strong> (must not regress):</p>
+<ul>
+<li><p>The stage/task execution model at shuffle boundaries.</p></li>
+<li><p>The AQE / adaptive planner path (partition coalescing, dynamic join
+selection, runtime broadcast), available and gated behind
configuration.</p></li>
+<li><p>Broadcast joins for small build sides, to avoid shuffles and skew (the
+equivalent of Spark’s broadcast hash join).</p></li>
+<li><p>The operational surface Spark users expect: a scheduler plus executors,
+task-slot concurrency, a tunable <code class="docutils literal
notranslate"><span class="pre">target_partitions</span></code>, and stage/task
+observability (task timings, a history server / UI) for debugging
skew.</p></li>
+<li><p>Behavior driven by configuration and <code class="docutils literal
notranslate"><span class="pre">SET</span></code>, not hard-coded planner
choices.</p></li>
+</ul>
+</li>
+<li><p><strong>Red flags in a pull request</strong>:</p>
+<ul>
+<li><p>Removing or short-circuiting the stage/task boundary model, or
collapsing
+toward single-process execution.</p></li>
+<li><p>Regressing or removing the AQE / adaptive planner path — or making it
the
+only path in a way that breaks Persona 1’s transparent static path.</p></li>
+<li><p>Hard-coding a join or planner strategy instead of gating it behind
+configuration.</p></li>
+<li><p>Removing the stage/task observability that Spark users rely on to
diagnose
+skew.</p></li>
+</ul>
+</li>
</ul>
</section>
-<section id="pyballista">
-<h2>PyBallista<a class="headerlink" href="#pyballista" title="Link to this
heading">#</a></h2>
+<section id="persona-3-the-library-user-building-a-specialized-engine">
+<h2>Persona 3: The library user building a specialized engine<a
class="headerlink"
href="#persona-3-the-library-user-building-a-specialized-engine" title="Link to
this heading">#</a></h2>
<ul class="simple">
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/tree/main/python";>Source</a></p></li>
-<li><p><a class="reference external"
href="https://github.com/apache/datafusion-ballista/blob/main/python/src/context.rs";>Context</a></p></li>
+<li><p><strong>Who</strong>: An engineer using Ballista as a
<em>framework</em> — the foundation for a
+specialized or bespoke distributed query engine — rather than as a turnkey
+cluster.</p></li>
+<li><p><strong>Coming from</strong>: Building on DataFusion as a library, now
needing distribution
+(or replacing a hand-rolled distributed layer).</p></li>
+<li><p><strong>Why Ballista</strong>: Reusable scheduler, executor, and
plan-serialization
+building blocks with extension points, instead of writing distributed
+execution from scratch.</p></li>
+<li><p><strong>Depends on</strong> (must not regress):</p>
+<ul>
+<li><p>Stable, composable public APIs across the <code class="docutils literal
notranslate"><span class="pre">scheduler</span></code>, <code class="docutils
literal notranslate"><span class="pre">executor</span></code>, <code
class="docutils literal notranslate"><span class="pre">client</span></code>,
+and <code class="docutils literal notranslate"><span
class="pre">core</span></code> crates (the execution graph and plan
serialization included).</p></li>
+<li><p>Extension points that do not require forking: custom object stores,
+physical/logical extension codecs, custom operators and functions, a
+pluggable runtime producer, custom session configuration, and a custom query
+planner.</p></li>
+<li><p>Behavior that stays <em>configurable rather than hard-coded</em>, so an
embedder can
+swap the planner, join strategy, partitioning, or runtime environment.</p></li>
+<li><p>Backward-compatible public APIs, with breaking changes signaled in the
+<a class="reference internal" href="../upgrading/index.html"><span class="doc
std std-doc">upgrade guide</span></a>.</p></li>
+<li><p>No assumptions baked into the core that only fit the built-in clients
or the
+TPC-H benchmark.</p></li>
+</ul>
+</li>
+<li><p><strong>Red flags in a pull request</strong>:</p>
+<ul>
+<li><p>Breaking a public API signature without an upgrade-guide entry.</p></li>
+<li><p>Hard-coding behavior that used to be pluggable, or removing an extension
+point (an extension-codec argument, the runtime-producer override,
+session-config injection).</p></li>
+<li><p>Coupling core logic to a specific client, planner, or benchmark instead
of
+keeping it behind a trait or configuration.</p></li>
+<li><p>Wire-format or serialization changes that break externally-produced
plans
+with no compatibility path.</p></li>
</ul>
+</li>
+</ul>
+</section>
+<section id="adding-a-persona">
+<h2>Adding a persona<a class="headerlink" href="#adding-a-persona" title="Link
to this heading">#</a></h2>
+<p>This registry is append-only. As Ballista attracts new kinds of users, add a
+persona for each one via a pull request, using the same schema (who they are,
+what they are coming from, why Ballista, what they depend on, and the red flags
+that would regress them). Do not remove existing personas: an audience that
+relied on Ballista does not stop existing because our priorities shifted, and
+the whole value of this page is that the guarantees only accumulate.</p>
</section>
</section>
@@ -443,12 +551,12 @@
<div class="prev-next-area">
<a class="left-prev"
- href="architecture.html"
+ href="code-organization.html"
title="previous page">
<i class="fa-solid fa-angle-left"></i>
<div class="prev-next-info">
<p class="prev-next-subtitle">previous</p>
- <p class="prev-next-title">Ballista Architecture</p>
+ <p class="prev-next-title">Ballista Code Organization</p>
</div>
</a>
<a class="right-next"
@@ -479,11 +587,11 @@
</div>
<nav id="pst-page-toc-nav" class="page-toc"
aria-labelledby="pst-page-navigation-heading-2">
<ul class="pst-show_toc_level nav section-nav flex-column">
-<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#ballista-core-crate">ballista-core crate</a></li>
-<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#ballista-scheduler-crate">ballista-scheduler crate</a></li>
-<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#ballista-executor-crate">ballista-executor crate</a></li>
-<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#ballista-crate">ballista crate</a></li>
-<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#pyballista">PyBallista</a></li>
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#why-this-page-exists">Why this page exists</a></li>
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#persona-1-the-datafusion-user-going-multi-node">Persona 1: The
DataFusion user going multi-node</a></li>
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#persona-2-the-spark-user-wanting-the-same-execution-model">Persona 2:
The Spark user wanting the same execution model</a></li>
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#persona-3-the-library-user-building-a-specialized-engine">Persona 3: The
library user building a specialized engine</a></li>
+<li class="toc-h2 nav-item toc-entry"><a class="reference internal nav-link"
href="#adding-a-persona">Adding a persona</a></li>
</ul>
</nav></div>
@@ -491,7 +599,7 @@
<div class="tocsection editthispage">
- <a
href="https://github.com/apache/datafusion-ballista/edit/main/docs/source/contributors-guide/code-organization.md";>
+ <a
href="https://github.com/apache/datafusion-ballista/edit/main/docs/source/contributors-guide/user-personas.md";>
<i class="fa-solid fa-pencil"></i>
@@ -506,7 +614,7 @@
<div class="sidebar-secondary-item">
<div class="tocsection sourcelink">
- <a href="../_sources/contributors-guide/code-organization.md.txt">
+ <a href="../_sources/contributors-guide/user-personas.md.txt">
<i class="fa-solid fa-file-lines"></i> Show Source
</a>
</div>
diff --git a/genindex.html b/genindex.html
index e72d503a1..2e2820add 100644
--- a/genindex.html
+++ b/genindex.html
@@ -295,6 +295,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/index.html b/index.html
index e33dc99d8..a1cd840e0 100644
--- a/index.html
+++ b/index.html
@@ -301,6 +301,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
@@ -398,6 +399,7 @@
<ul>
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/objects.inv b/objects.inv
index 38651ed38..668ba4d1e 100644
Binary files a/objects.inv and b/objects.inv differ
diff --git a/search.html b/search.html
index b1c91aa11..13a851b40 100644
--- a/search.html
+++ b/search.html
@@ -294,6 +294,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/searchindex.js b/searchindex.js
index 92b81df85..d4b6d095b 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"alltitles":{"AQE join behavior
(opt-in)":[[25,"aqe-join-behavior-opt-in"]],"Adaptive Query Execution
(AQE)":[[21,"adaptive-query-execution-aqe"]],"Adaptive Query Execution
(Experimental)":[[47,"adaptive-query-execution-experimental"]],"Aggregate
Functions":[[46,"aggregate-functions"]],"Apache DataFusion
Ballista":[[24,null]],"Apache DataFusion Ballista 0.10.0
Changelog":[[0,null]],"Apache DataFusion Ballista 0.11.0
Changelog":[[1,null]],"Apache DataFusion Ballista 0.12. [...]
\ No newline at end of file
+Search.setIndex({"alltitles":{"AQE join behavior
(opt-in)":[[26,"aqe-join-behavior-opt-in"]],"Adaptive Query Execution
(AQE)":[[21,"adaptive-query-execution-aqe"]],"Adaptive Query Execution
(Experimental)":[[48,"adaptive-query-execution-experimental"]],"Adding a
persona":[[24,"adding-a-persona"]],"Aggregate
Functions":[[47,"aggregate-functions"]],"Apache DataFusion
Ballista":[[25,null]],"Apache DataFusion Ballista 0.10.0
Changelog":[[0,null]],"Apache DataFusion Ballista 0.11.0 Changelog" [...]
\ No newline at end of file
diff --git a/upgrading/54.0.0.html b/upgrading/54.0.0.html
index 02f599539..8bc802d33 100644
--- a/upgrading/54.0.0.html
+++ b/upgrading/54.0.0.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/upgrading/index.html b/upgrading/index.html
index 3c05d9c1d..d126e829f 100644
--- a/upgrading/index.html
+++ b/upgrading/index.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/cli.html b/user-guide/cli.html
index 671ae3010..0de853711 100644
--- a/user-guide/cli.html
+++ b/user-guide/cli.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/configs.html b/user-guide/configs.html
index b1716ed34..ea3f587bf 100644
--- a/user-guide/configs.html
+++ b/user-guide/configs.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/deployment/cargo-install.html
b/user-guide/deployment/cargo-install.html
index 5afc17c22..56182ba5c 100644
--- a/user-guide/deployment/cargo-install.html
+++ b/user-guide/deployment/cargo-install.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/deployment/docker-compose.html
b/user-guide/deployment/docker-compose.html
index 2e2ae49b1..8f0f0e3ae 100644
--- a/user-guide/deployment/docker-compose.html
+++ b/user-guide/deployment/docker-compose.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/deployment/docker.html
b/user-guide/deployment/docker.html
index f62b17ac2..745745f40 100644
--- a/user-guide/deployment/docker.html
+++ b/user-guide/deployment/docker.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/deployment/index.html b/user-guide/deployment/index.html
index 00c423ba6..57482c626 100644
--- a/user-guide/deployment/index.html
+++ b/user-guide/deployment/index.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/deployment/kubernetes.html
b/user-guide/deployment/kubernetes.html
index 0269b0df8..6888414a0 100644
--- a/user-guide/deployment/kubernetes.html
+++ b/user-guide/deployment/kubernetes.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/deployment/quick-start.html
b/user-guide/deployment/quick-start.html
index afbede2b0..ece78ceba 100644
--- a/user-guide/deployment/quick-start.html
+++ b/user-guide/deployment/quick-start.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/extending-components.html
b/user-guide/extending-components.html
index 0e1f6eaea..efa474d0f 100644
--- a/user-guide/extending-components.html
+++ b/user-guide/extending-components.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/extensions-example.html
b/user-guide/extensions-example.html
index 514554ed1..ccb1467b8 100644
--- a/user-guide/extensions-example.html
+++ b/user-guide/extensions-example.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/faq.html b/user-guide/faq.html
index 4ebe3ca59..5221c7eb2 100644
--- a/user-guide/faq.html
+++ b/user-guide/faq.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/introduction.html b/user-guide/introduction.html
index b27c056f9..64bb24c4e 100644
--- a/user-guide/introduction.html
+++ b/user-guide/introduction.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/metrics.html b/user-guide/metrics.html
index 9b2496646..d69fc35e9 100644
--- a/user-guide/metrics.html
+++ b/user-guide/metrics.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/python/cloud-storage.html
b/user-guide/python/cloud-storage.html
index 2960f219c..084bc0db3 100644
--- a/user-guide/python/cloud-storage.html
+++ b/user-guide/python/cloud-storage.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/python/index.html b/user-guide/python/index.html
index 1f275ef3c..0051fd8de 100644
--- a/user-guide/python/index.html
+++ b/user-guide/python/index.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/python/jupyter.html b/user-guide/python/jupyter.html
index 3786c9c32..0a7dbe282 100644
--- a/user-guide/python/jupyter.html
+++ b/user-guide/python/jupyter.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/python/quickstart.html
b/user-guide/python/quickstart.html
index 3ed69187d..917fb20ef 100644
--- a/user-guide/python/quickstart.html
+++ b/user-guide/python/quickstart.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/rust.html b/user-guide/rust.html
index 4058459e5..fa8a08150 100644
--- a/user-guide/rust.html
+++ b/user-guide/rust.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/scheduler.html b/user-guide/scheduler.html
index 4ab52da48..e4fe26b5e 100644
--- a/user-guide/scheduler.html
+++ b/user-guide/scheduler.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/spark-compatible-functions.html
b/user-guide/spark-compatible-functions.html
index bac14fcdc..57661f290 100644
--- a/user-guide/spark-compatible-functions.html
+++ b/user-guide/spark-compatible-functions.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
diff --git a/user-guide/tuning-guide.html b/user-guide/tuning-guide.html
index 98de61e7c..e73c3312b 100644
--- a/user-guide/tuning-guide.html
+++ b/user-guide/tuning-guide.html
@@ -300,6 +300,7 @@
<ul class="nav bd-sidenav">
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/architecture.html">Ballista Architecture</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/code-organization.html">Ballista Code
Organization</a></li>
+<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/user-personas.html">User Personas</a></li>
<li class="toctree-l1"><a class="reference internal"
href="../contributors-guide/development.html">Ballista Development</a></li>
<li class="toctree-l1"><a class="reference external"
href="https://github.com/apache/datafusion-ballista/";>Source code</a></li>
</ul>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
