Repository navigation
Add an FAQ page that search engines and AI assistants can quote - #218
Merged
Merged
Conversation
/faq answers the questions people ask search engines and AI assistants about Vortex: what it is, how it compares to Parquet, when to use it, why it is fast, whether the format is stable, how to install it, who uses it, who maintains it, and where to get help. The comparison with Parquet carries the homepage's figures from bench, and the adopters and install commands come from the homepage's own lists, so the page cannot fall behind them. The page draws the design system's Article card, as a blog post does. The footer links to it on both sites, the sitemap lists it, llms.txt links it, and llms-full.txt gives it in full. verify checks that its FAQPage data has one question per heading, and the axe run covers it. Signed-off-by: Will Manning <will@willmanning.io>
Each figure now names its source and class: bench's results are public benchmarks, and the GPU figure is an internal measurement, explained in plain words after the list. The size tradeoff carries bench's number. No sentence is over 25 words, the license line no longer repeats, and the adopters are a list. Signed-off-by: Will Manning <will@willmanning.io>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
🔦 Lighthouse audit
Run |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 38deb9bf16
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
… as such The answer to "Should I use Vortex instead of Parquet?" now lists only the workloads where bench's newest verdict says Vortex is faster, names any where Parquet is faster, and points to bench when its results could not be read. The adopters answer, and the matching llms.txt line, now say the list holds adopters and the projects Vortex works with. Signed-off-by: Will Manning <will@willmanning.io>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 07c08b328d
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
The lead-in says "For most workloads, yes" only when Vortex wins more than half the speed panels, and "It depends on the workload" when it wins fewer. Parquet's size advantage drops out only when bench measures Vortex's files as smaller or the same size; without a size verdict the answer points to bench and keeps storage cost in the last sentence. Signed-off-by: Will Manning <will@willmanning.io>
…arisons A new answer says how Lance differs: a table format and a file format with one name, with indexes and versions, where Vortex is only a file format that table formats store. It lists bench's newest verdicts for Vortex against Lance, and how each project is governed. /faq now reads bench's TPC-H SF10 scores on DataFusion (morePanelsFrom), and lists them after ClickBench in both comparisons. The homepage table is unchanged, and does not depend on them. Signed-off-by: Will Manning <will@willmanning.io>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 81bb943442
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
The sentence on proposed table formats ended "has a proposal to." It now says "has a proposal to store tables in Vortex files", and stands on its own when no shipped table format is listed. Signed-off-by: Will Manning <will@willmanning.io>
The Lance answer now says how the Vortex charter changes (two thirds of the Technical Steering Committee and LF Projects' approval), and that LanceDB, a private company, holds Lance's name and code rather than an independent foundation. Signed-off-by: Will Manning <will@willmanning.io>
…ents The governance answer now lists the organizations Vortex's committers and maintainers are affiliated with, and links the LF AI & Data press release and the post on donating Vortex. Signed-off-by: Will Manning <will@willmanning.io>
Signed-off-by: Will Manning <will@willmanning.io>
The answer said each release from 0.36.0 on reads files from any other release from 0.36.0 on. The docs guarantee only that a release reads files from earlier releases; an older reader needs the writer to target an edition it supports. The answer now says so and links the docs' versioning page. Signed-off-by: Will Manning <will@willmanning.io>
2 tasks done
lwwmanning
added a commit
that referenced
this pull request
Nov 11, 2026
Signed-off-by: Will Manning <will@willmanning.io> # Conflicts: # src/lib/faq.ts
lwwmanning
added a commit
to vortex-data/vortex
that referenced
this pull request
Nov 11, 2026
## Summary vortex.dev has a new FAQ page, https://vortex.dev/faq, from vortex-data/vortex.dev#218. This PR links it from the docs: in the footer before Charter, as the vortex.dev footer has it, in the project page's links, and in the docs' llms.txt beside the homepage. ## Changes `make -C docs html` builds with no warnings, and the built footer, project page, and llms.txt each carry the link. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Signed-off-by: Will Manning <will@willmanning.io>
This branch was successfully deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changes
vortex.dev has a new page,
/faq. It answers nine common questions about Vortex, for example how it compares to Parquet, when to use it, and how to install it. The page has FAQPage structured data with the same text, so search engines and AI assistants can quote the answers. The Parquet comparison, the adopters, and the install commands come from the homepage's data, so they stay current. The footer links the page on vortex.dev and on bench. The sitemap lists it,/llms.txtlinks it, and/llms-full.txtincludes it.How it was checked
bun run build,bun run test,bun run test:bench,bun run knip, and the typecheck pass.bun run verifypasses against a local production build. It now checks that the FAQPage data has one question for each heading on the page. The axe run now includes/faq.Footer, before and after (dark theme):
The new page:
git commit -s), for the DCO check.bun run check:cipasses.🤖 Generated with Claude Code