Skip to content

docs: pgvector guide audit fixes - #6932

Open
danieltprice wants to merge 2 commits into
mainfrom
docs/ext-pgvector-guide-audit-fixes
Open

danieltprice wants to merge 2 commits into
mainfrom
docs/ext-pgvector-guide-audit-fixes

Conversation

@danieltprice

Copy link
Copy Markdown
Collaborator
  • Update the previous-version example to 0.8.6 (latest is 0.8.7)
  • Cast the binary_quantize query literal to vector so the example runs
  • List the IVFFlat index build phases instead of the HNSW ones
  • Fix the probes link and a broken heading anchor
  • Remove a duplicate note, a stray character, and an unsourced accuracy figure
  • Drop the max_worker_processes value from the parallel workers text

NEON PREVIEW

This pull request and its description were written by Isaac.

- Update the previous-version example to 0.8.6 (latest is 0.8.7)
- Cast the binary_quantize query literal to vector
- List the IVFFlat index build phases
- Remove the duplicate note, stray text, and an unsourced accuracy figure
- Fix the probes link and the progress heading anchor
- Remove the max_worker_processes value

Co-authored-by: Isaac <no-reply@databricks.com>
@vercel

vercel Bot commented Nov 21, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
neon-next Ready Ready Preview Nov 21, 2026 12:04pm UTC

Request Review

- Use Postgres in the link labels
- Replace a filler transition

Co-authored-by: Isaac <no-reply@databricks.com>
@danieltprice

Copy link
Copy Markdown
Collaborator Author

Live test results

Tested on a throwaway Postgres 18 project with every SQL block run in order. Version checks ran on Postgres 14 to 19.

Step Result
CREATE EXTENSION and version query (0.8.7) ✅ Passed
Table, insert, upsert, update, and delete ✅ Passed
Query operators and distance outputs ✅ Passed
HNSW indexes, build options, and hnsw.ef_search ✅ Passed
IVFFlat indexes and ivfflat.probes ✅ Passed
Previous version install (0.8.6) 🔧 Needed a fix (guide showed 0.7.4)
maintenance_work_mem and parallel worker settings ✅ Passed
Binary quantization 🔧 Needed a fix (literal needed a ::vector cast)
Bit vectors (Hamming and Jaccard) ✅ Passed
halfvec and sparsevec ✅ Passed
Filtering and partitioning ✅ Passed
Binary COPY with a Python client ✅ Passed
NULL distance outputs ✅ Passed (matches the 0.7.0 output shown)
Invalid literal error ✅ Passed
Dimension limits (vector 2,000, halfvec 4,000, bit 64,000, sparsevec 1,000 non-zero) ✅ Passed
Index progress phases 🔧 Needed a fix (IVFFlat listed the HNSW phases)
Default settings (ef_search, probes, maintenance_work_mem) ✅ Passed

Doc errors fixed in this PR:

  • The IVFFlat section listed the HNSW progress phases.
  • The binary_quantize example fails on Postgres as written.
  • The previous-version example was 0.7.4, two versions back.
  • The probes link and a heading anchor pointed to missing anchors.
  • A duplicate note and a stray quote in the text.

Not verified: the max_worker_processes value. The page said 13, and a 1 CU compute reports 15, so the value is now left out of the text.

This branch was successfully deployed

1 active deployment
Preview – neon-next — 1e227942 Deployed Nov 21, 2026 by vercel[bot]
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.

1 participant