DRAFT: Rough rough draft of onboarding guide#70
Conversation
| dbc install sqlite | ||
| ``` | ||
|
|
||
| ## Run a Query |
There was a problem hiding this comment.
Should we link to the quickstarts?
|
"Foundry staff" has a connotation that we're paid employees of the Foundry. How about changing it to "Foundry administrators" (or "admins" for short) when referring to people with admin permissions, and "Foundry contributors" when referring to the broader group? |
|
I'd like this post to go harder sooner on the specific core reasons why creating ADBC drivers in disparate third-party repos is an anti-pattern and creating them in the Driver Foundry is the way to go. |
| 3. Foundry staff adds templates with common workflows, CI, and validation. | ||
| 4. They invite members of your team and give you appropriate access. | ||
| 5. You develop the driver as you see fit. | ||
| 6. When you tag a release, Foundry staff can help coordinate making it available with [dbc](https://columnar.tech/dbc). |
There was a problem hiding this comment.
I think it would be better to describe the build and distribution process generically and cite dbc as an example of one important distribution channel.
|
|
||
| ### Why not under apache/arrow-adbc? | ||
|
|
||
| TODO: Talk about this |
There was a problem hiding this comment.
You can reuse the explanation of this from https://adbc-drivers.org/2025/10/29/announcing-adbc-driver-foundry.html
I took a stab at this as well. |
Co-authored-by: Ian Cook <ianmcook@gmail.com>
| ^^^ | ||
| Learn how to build an ADBC driver in the Foundry. | ||
| +++ | ||
| :::{button-ref} building-drivers/index |
There was a problem hiding this comment.
I feel like this should go after the list of drivers itself. Or we need some landing page setup with two buttons/sections, one for users/drivers and one for contributors/vendors.
There was a problem hiding this comment.
I need to do more work on this. The page is currently too whitespace-heavy and I think we want to show more before thee user has to scroll. I think drivers first makes sense but I want to make sure people actually see the resources for using/building.
There was a problem hiding this comment.
We can probably tweak the margins and such too.
There was a problem hiding this comment.
I think this might work well. Keep the drivers up top but just add a banner sort of thing guiding people:
3 participants
This PR pairs with adbc-drivers/adbc-drivers.org#28.