The content of pyo.dev/docs. This repo only holds the writing: pyo-web renders it.
Pages are MDX files in content/, and each folder's meta.json sets the order
in the sidebar. The four segments in the sidebar's switcher are the folders
(core), cli, api and mcp. The brackets keep (core) out of the URLs. To preview your changes, run the site next to this repo:
cd ../pyo-web
bun run dev # copies the docs, then serves http://localhost:3000/docsDon't edit these: they come from the code, so they can't drift from it.
content/cli/commands.mdx, from the CLI's own helpcontent/mcp/tools.mdx, from the tool list incrates/pyo-api/src/mcp.rsopenapi/pyo.json, the API reference, from the API's codeschema/pyo.json, the JSON Schema ofpyo.jsonc, from the CLI's code. pyo.dev serves it at https://pyo.dev/schema/pyo.json
To update them, with the pyo repo next to this one:
cargo build -p pyo-cli # in ../pyo
bun run generate # here
cargo run -p pyo-api --bin openapi # in ../pyo, writes openapi/pyo.json here
PYO_WRITE_SCHEMA=1 cargo test -p pyo-cli schema # in ../pyo, writes schema/pyo.json herePages and cards take an icon by name: icon: rocket in a page's frontmatter, or
<Card icon="rocket" ... />. The names are in src/lib/docs-icons.tsx in
pyo-web.
The code and content are under the Apache License 2.0.