Skip to content

Document existing TurboQuant types#8053

Merged
connortsui20 merged 1 commit into
developfrom
ct/tq-docs
May 22, 2026
Merged

Document existing TurboQuant types#8053
connortsui20 merged 1 commit into
developfrom
ct/tq-docs

Conversation

@connortsui20
Copy link
Copy Markdown
Contributor

@connortsui20 connortsui20 commented May 21, 2026

Summary

Tracking issue: #7830

Adds a lot more documentation for the TurboQuant implementation (since in hindsight there are a lot of things that might not be obvious).

Testing

N/A

@connortsui20 connortsui20 requested review from a team, gatesn and palaska May 21, 2026 19:30
@connortsui20 connortsui20 added the changelog/docs A docs change label May 21, 2026
@codspeed-hq
Copy link
Copy Markdown

codspeed-hq Bot commented May 21, 2026

Merging this PR will improve performance by 19.8%

⚠️ Unknown Walltime execution environment detected

Using the Walltime instrument on standard Hosted Runners will lead to inconsistent data.

For the most accurate results, we recommend using CodSpeed Macro Runners: bare-metal machines fine-tuned for performance measurement consistency.

⚡ 1 improved benchmark
✅ 1250 untouched benchmarks

Performance Changes

Mode Benchmark BASE HEAD Efficiency
Simulation chunked_varbinview_opt_canonical_into[(1000, 10)] 225.2 µs 188 µs +19.8%

Tip

Curious why this is faster? Comment @codspeedbot explain why this is faster on this PR, or directly use the CodSpeed MCP with your agent.


Comparing ct/tq-docs (70e6a90) with develop (1a5079b)

Open in CodSpeed

@connortsui20 connortsui20 requested a review from mprammer May 21, 2026 19:46
Doc-comment pass over the parts of vortex-turboquant that don't depend on the in-flight
inv_direction_norms work: SplitMix64, the vector module, DecodeInputs's pre-existing fields,
TurboQuant + TurboQuantMetadata + their fields, the TurboQuantMetadataProto wire-format note,
validate_tq_metadata, validate_tq_storage_dtype, and the TurboQuantParsedStorage struct +
existing fields. No semantic change.

Signed-off-by: Connor Tsui <connor.tsui20@gmail.com>
@connortsui20 connortsui20 enabled auto-merge (squash) May 22, 2026 19:25
@connortsui20 connortsui20 merged commit 495f30e into develop May 22, 2026
62 checks passed
@connortsui20 connortsui20 deleted the ct/tq-docs branch May 22, 2026 20:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

changelog/docs A docs change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants