Skip to content

docs(readme): reorganize for end users - #359

Merged
eddietejeda merged 4 commits into
mainfrom
docs/readme-end-users
Oct 19, 2026
Merged

eddietejeda merged 4 commits into
mainfrom
docs/readme-end-users

Conversation

@eddietejeda

Copy link
Copy Markdown
Contributor

Reorganizes the README around what a new user does first: install, quickstart, load data, query. Reference material moves to the end.

  • Shorter install section. Installer flags move to the configuration reference.
  • Numbered quickstart that explains catalog.schema.table.
  • Plain-language sections for loading, querying (including SQL writes), joins and search. Internal ids and jargon are gone.
  • Adds the current workspace and database section, including that -d accepts a name, catalog or id (fix(cli): accept database names and catalogs in every -d flag #280).
  • The Claude Code plugin section is condensed, and its "what it runs, sends, and fetches" disclosure stays verbatim in a collapsible block.
  • The command table and environment variables collapse under Reference.
  • "HotData" is now "Hotdata" throughout.

No commands or behaviour change.

@eddietejeda
eddietejeda requested a review from a team as a code owner October 19, 2026 01:41
@eddietejeda
eddietejeda requested review from shefeek-jinnah and removed request for a team October 19, 2026 01:41
Comment thread README.md
- Authenticate without a browser using an API key: `--api-key <key>`, or
`HOTDATA_API_KEY` in your environment or a `.env` file.
- `hotdata query status` and `hotdata ingest run` return exit codes scripts can
check: `0` done, `1` failed, `2` still running.

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: Add exit code 3 for hotdata query status (not blocking).

query status also exits 3 when the query succeeded but the printed result is a truncated preview. src/commands/query.rs:61 defines EXIT_INCOMPLETE_RESULT = 3. The previous README documented exit code 3. A script that follows this list treats exit code 3 as an unknown failure.

Suggested change
check: `0` done, `1` failed, `2` still running.
check: `0` done, `1` failed, `2` still running. `query status` also returns
`3` when the query is done but the printed result is a truncated preview.

claude[bot]
claude Bot previously approved these changes Oct 19, 2026
claude[bot]
claude Bot previously approved these changes Oct 19, 2026
claude[bot]
claude Bot previously approved these changes Oct 19, 2026
@codecov

codecov Bot commented Oct 19, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@eddietejeda
eddietejeda merged commit 2eaa773 into main Oct 19, 2026
15 checks passed
@eddietejeda
eddietejeda deleted the docs/readme-end-users branch October 19, 2026 01:52
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