Skip to content

docs: README restructure with quickstart, benchmarks, and a collapsed usage guide - #431

Merged
rejojer merged 26 commits into
mainfrom
feat/newreadme
Aug 26, 2026
Merged

docs: README restructure with quickstart, benchmarks, and a collapsed usage guide#431
rejojer merged 26 commits into
mainfrom
feat/newreadme

Conversation

@rejojer

@rejojer rejojer commented Aug 26, 2026

Copy link
Copy Markdown
Member

Follow-up on the README rewrite. Earlier snapshots of this branch already landed on main via #418/#419, so the Files view shows the whole rewrite. What this PR actually changes on top of main:

  • Quickstart switches to the v0.2.11 two-switch spellings: PageIndexClient(index=..., chat=...); Model Recommendations follow suit, and the Detailed Usage Guide notes the flat index_model=/chat_model= spellings also work
  • New Get Answers with Citations quickstart example (system message + <cite/> output)
  • Benchmarks: adds indexing time (nine PDFs, 13 s – 4.5 min) with assets/index-time-{light,dark}.png
  • Integrate PageIndex with your own agent moves out of the Detailed Usage Guide into its own collapsed block, now anchor-linkable from the quickstart
  • PageIndex Cloud section rewritten: PAGEINDEX_API_KEY + index="cloud" migration snippet, capability table with a Best-for row, and the managed chat (included with the key) visible again
  • Restores the reasoning positioning trimmed by the rewrite: the Why it works quote, search that tree with LLM reasoning, agentically, and the comparison-table row LLM reasoning over the tree

Docs-only: README.md + two images.

https://claude.ai/code/session_01Tr1rUa2hjxSJZ41smfMaxu

zmtomorrow and others added 19 commits August 20, 2026 05:32
…tart cross-links

- Retrieve step and the comparison table say LLM reasoning again, and the
  'Why it works' quote returns above the table
- Model Recommendations use the quickstart's index=/chat= spellings; the
  usage guide notes the flat spellings are interchangeable
- the own-agent integration block gets an anchor and the quickstart pointer
  links to it instead of claiming it lives in the Detailed Usage Guide
- cloud table shows the managed chat included with the key; wait=True
  explained; em-dash spacing and heading whitespace
rejojer added a commit that referenced this pull request Aug 26, 2026
dash.pageindex.ai/api-keys now 307-redirects to
developer.pageindex.ai/api-keys, and the README (PR #431) already
standardized on the developer domain — the client docstring and the
CloudClient keyless error message were the last SDK references to the
old host.
Every prose em dash converts to a colon, comma, semicolon, or
parentheses (label bullets take colons; parenthetical pairs become
parentheses). The two table cells that use the dash as a not-available
marker stay. Also: "flips to" becomes "goes straight to", and the
Context table row gains "etc."
@rejojer rejojer changed the title docs: README restructure — quickstart, benchmarks, collapsed usage guide docs: README restructure with quickstart, benchmarks, and a collapsed usage guide Aug 26, 2026
The earlier snapshots landed on main as squashes (#418/#419), so the
continued edits conflicted with them. The branch README is the reviewed
final; everything else takes main.
@rejojer
rejojer merged commit f47f27b into main Aug 26, 2026
5 of 8 checks passed
@rejojer
rejojer deleted the feat/newreadme branch August 26, 2026 19:28
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.

2 participants