[gouyt13]

Summary

Make the repository and documentation homepages easier to navigate: introduce vector indexes before quantization components, shorten the quick-start path, and collect papers on a dedicated page. Show GIST1M throughput and serialized index size using existing measurements, with actual recall, parameters and measurement limits linked from the homepage. A plotting script keeps the figure and selected-result tables synchronized.

Document txtai and zvec integrations with versioned sources and explicit API/platform boundaries. Move developer/maintainer guides under docs/, consolidate maintenance contacts into CONTRIBUTING, and move example runners under sample/ with repository-root path resolution. Update references and the CI path-test fixture.

No library algorithms, public APIs, persisted formats or production dependencies change. No new benchmark measurements are claimed; agent workflow pilot files are excluded.

Testing

• Strict MkDocs build passed; Material emits its existing informational MkDocs 2.0 advisory.
• Checked 122 local file links and README navigation; executed the README Python example in the existing environment.
• Verified chart values against committed CSVs, byte-identical repeated regeneration, and visual layout.
• Python lint/format checks, focused Ruff checks, and 12 CI routing tests passed.
• ShellCheck and shell syntax checks passed; verified relocated runners resolve the repository root and preserve workflow commands.
• Full diff whitespace check passed.

Full dataset example runs and downstream txtai end-to-end tests were not rerun. Integration pages distinguish source inspection from runtime validation.