Skip to content

docs: fix two stale README claims - #136

Merged
eddietejeda merged 1 commit into
mainfrom
docs/readme-accuracy
Sep 10, 2026
Merged

docs: fix two stale README claims#136
eddietejeda merged 1 commit into
mainfrom
docs/readme-accuracy

Conversation

@eddietejeda

@eddietejeda eddietejeda commented Sep 10, 2026

Copy link
Copy Markdown
Contributor

README accuracy audit against source at v0.16.0 (same flow as hotdata-dev/hotdata-ibis#55).

  • Install snippets pinned hotdata = "0.1" in three places — cargo resolves that to the old 0.1.x line, which predates the auth changes this README itself describes. Now "0.16"
  • QueryError was phrased as a complete list with 4 variants; src/query.rs has 6 — added Async and Poll

Everything else verified against source, including the handle table (the 0.15.0 removals are correctly absent). One claim left unverified: "Rust 1.74+" — no rust-version in Cargo.toml and no MSRV check in CI.

- Install snippets pinned hotdata = "0.1" in three places; the crate is
  at 0.16.0, and cargo resolves "0.1" to the old 0.1.x line. Now "0.16".
- The QueryError paragraph listed four variants as if complete
  ("... and Result(ResultError)"), omitting Async (server fell back to
  asynchronous execution, HTTP 202) and Poll (API error while polling
  during auto-follow) — src/query.rs has six.
@eddietejeda
eddietejeda requested a review from a team as a code owner September 10, 2026 03:02
@eddietejeda
eddietejeda requested review from shefeek-jinnah and removed request for a team September 10, 2026 03:02
Comment thread README.md
```toml
[dependencies]
hotdata = { version = "0.1", features = ["arrow"] }
hotdata = { version = "0.16", features = ["arrow"] }

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: the same stale pin survives in src/arrow.rs:29 (not blocking).

That module doc carries hotdata = { version = "0.1", features = ["arrow"] }. docs.rs renders it with all-features = true, so a reader of the arrow module page still gets the 0.1.x pin this PR removes from README.md. Update src/arrow.rs:29 to version = "0.16" for consistency.

Comment thread README.md
for `async` queries), `Async` (the server fell back to asynchronous execution
with a 202; the acknowledgement is passed through), `Poll` (an API error while
polling during auto-follow), and `Result(ResultError)` for truncation
auto-follow failures (`TooLarge` / `Timeout` / `Incomplete` / …). Result-polling and

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

super nit: this line runs to 86 columns (not blocking). Surrounding prose wraps at 80.

Suggested change
auto-follow failures (`TooLarge` / `Timeout` / `Incomplete` / …). Result-polling and
auto-follow failures (`TooLarge` / `Timeout` / `Incomplete` / …). Result-polling
and

Comment thread README.md
Comment on lines +199 to 200
auto-follow failures (`TooLarge` / `Timeout` / `Incomplete` / …). Result-polling and
one-call helpers return `hotdata::AwaitResultError` / `hotdata::QueryToArrowError`.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

super nit: use this reflow instead of the single-line suggestion above (not blocking). The single-line version leaves and alone on its own line.

Suggested change
auto-follow failures (`TooLarge` / `Timeout` / `Incomplete` / …). Result-polling and
one-call helpers return `hotdata::AwaitResultError` / `hotdata::QueryToArrowError`.
auto-follow failures (`TooLarge` / `Timeout` / `Incomplete` / …). Result-polling
and one-call helpers return `hotdata::AwaitResultError` /
`hotdata::QueryToArrowError`.

@eddietejeda
eddietejeda merged commit 55fc01a into main Sep 10, 2026
3 checks passed
@eddietejeda
eddietejeda deleted the docs/readme-accuracy branch September 10, 2026 03:09
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