Skip to content

doc: Add Ballista extensions example to the docs. - #1382

Merged
milenkovicm merged 17 commits into
apache:mainfrom
LouisBurke:feat/extensions-tutorial-issue-1370
Jan 18, 2026
Merged

doc: Add Ballista extensions example to the docs.#1382
milenkovicm merged 17 commits into
apache:mainfrom
LouisBurke:feat/extensions-tutorial-issue-1370

Conversation

@LouisBurke

Copy link
Copy Markdown
Contributor

Which issue does this PR close?

Closes #1370.

Rationale for this change

The Ballista docs need detail on how to do extensions.

What changes are included in this PR?

Markdown additions.

Are there any user-facing changes?

More document info, specifically extensions example.

@LouisBurke LouisBurke changed the title Feat/extensions tutorial issue 1370 Add Ballista Extensions example to the docs. Jan 16, 2026
@milenkovicm milenkovicm changed the title Add Ballista Extensions example to the docs. doc: Add Ballista extensions example to the docs. Jan 16, 2026

@milenkovicm milenkovicm left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks @LouisBurke
just a minor comment regarding links, i think we should remove them

Comment thread docs/source/user-guide/extensions-example.md Outdated
Comment thread docs/source/user-guide/extensions-example.md Outdated
}
```

The [custom planner](src/planner/custom_planner.rs) is registered in the session state as follows:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this link will be dead, we don't really need it, can we remove it?

Comment thread docs/source/user-guide/extensions-example.md Outdated

```

This should be all moving parts necessary to extend ballista functionality. Last step would be to configure [scheduler](examples/ballista_scheduler.rs) and [executor](examples/ballista_executor.rs) to use new features.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this link will be dead, we don't really need it, can we remove it?

Comment on lines +484 to +485
- [Ballista Extensions Source Code](https://github.com/milenkovicm/ballista_extensions)
- [Apache Arrow Ballista](https://datafusion.apache.org/ballista/)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we do not need this two links as well

@milenkovicm milenkovicm left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks @LouisBurke
I've updated those few small comments i had

@milenkovicm
milenkovicm merged commit 38fca8b into apache:main Jan 18, 2026
4 checks passed
@LouisBurke

Copy link
Copy Markdown
Contributor Author

Hi @milenkovicm ,
I had some other small edits and comments but fair enough. One thing is how we would host code examples?
My only idea was to add the example code to the Ballista project?
Lou

@milenkovicm

Copy link
Copy Markdown
Contributor

if you have further changes please do open new PR .
we can store them to examples folder, but i did not want to bring such a big codebase for now

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document ballista extensions with examples

2 participants