Skip to content

docs: bring docs/ in sync with v0.1 surface#35

Merged
mahimairaja merged 3 commits intomainfrom
feat/light-websocket-docs
May 4, 2026
Merged

docs: bring docs/ in sync with v0.1 surface#35
mahimairaja merged 3 commits intomainfrom
feat/light-websocket-docs

Conversation

@mahimairaja
Copy link
Copy Markdown
Collaborator

Three updates so the VitePress site reflects what shipped:

  • docs/api/pool.md: AgentPool constructor section now lists every v0.1 kwarg (isolation, max_concurrent_sessions, consecutive_failure_limit) in a typed table, documents the matching read-only properties, and adds a migration note linking to the v0.1.0 changelog. The server and run() sections call out the coroutine vs process distinction. New "See also" footer links to architecture, density benchmark, and changelog.
  • docs/getting-started.md: bump stale livekit-agents~=1.4 reference to ~=1.5 to match the actual pin.
  • docs/index.md: add a coroutine-mode-worker hero feature; surface the density benchmark + changelog in the "Read the docs" list.

The audit doc (historical snapshot) is intentionally untouched.

Summary

Type of change

  • Bug fix (non-breaking)
  • New feature (non-breaking)
  • Breaking change (note the migration impact below)
  • Refactor / internal cleanup (no behavior change)
  • Documentation only
  • CI / tooling

Verification

  • make ci passes locally (lint, format-check, typecheck, tests + 99% coverage gate).
  • New tests added or existing tests updated to cover the change.
  • Public API or CLI surface changes are reflected in docs/ and README.md (if applicable).
  • Changelog entry added under ## [Unreleased] in docs/changelog.md (for user-visible changes).

Notes for the reviewer

Three updates so the VitePress site reflects what shipped:

- docs/api/pool.md: AgentPool constructor section now lists every
  v0.1 kwarg (`isolation`, `max_concurrent_sessions`,
  `consecutive_failure_limit`) in a typed table, documents the
  matching read-only properties, and adds a migration note linking
  to the v0.1.0 changelog. The `server` and `run()` sections call
  out the coroutine vs process distinction. New "See also" footer
  links to architecture, density benchmark, and changelog.
- docs/getting-started.md: bump stale `livekit-agents~=1.4`
  reference to `~=1.5` to match the actual pin.
- docs/index.md: add a coroutine-mode-worker hero feature; surface
  the density benchmark + changelog in the "Read the docs" list.

The audit doc (historical snapshot) is intentionally untouched.
@mahimairaja mahimairaja self-assigned this May 3, 2026
@mahimairaja mahimairaja added the documentation Improvements or additions to documentation label May 3, 2026
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 3, 2026

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 7373b5e9-2ff2-4667-ba13-2c9ae72f1f43

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/light-websocket-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@codecov
Copy link
Copy Markdown

codecov Bot commented May 3, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Cleans up the repo root by relocating the docs-only Node package
files inside the docs/ directory:

- `package.json` + `package-lock.json` -> `docs/`. Repo root now
  has zero JS files; the only package files are the Python ones
  (pyproject.toml + uv.lock).
- npm scripts updated: `vitepress dev docs` -> `vitepress dev .`
  (now relative to docs/).
- .github/workflows/docs.yml + deploy-docs.yml run their npm
  steps under `defaults.run.working-directory: docs`. Path
  filters dropped the now-stale `package.json` /
  `package-lock.json` entries; `cache-dependency-path` /
  `hashFiles` updated to `docs/package-lock.json`.

Also extends .gitignore for two transient artifacts that the
new layout / build workflow can produce locally:

- `docs/.vitepress/dist/`, `docs/.vitepress/cache/` (VitePress
  build output / cache).
- `.smoke/` (throwaway uv venv used by the wheel-smoke-install
  step in build.yml).

Verified locally: `cd docs && npm install && npm run docs:build`
completes; `make ci` is green (374 tests pass, 100% coverage).

Run docs locally with `cd docs && npm run docs:dev` (was
`npm run docs:dev` from the repo root).
@mahimairaja mahimairaja merged commit 81259f0 into main May 4, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant