Rolly Calma
0822c83367
## Summary - write generated Python reference docs with explicit UTF-8 encoding ## Problem `Path.write_text()` uses the platform default encoding if none is specified. The generated reference content can include non-ASCII text, so this docs generator can behave differently on Windows or other non-UTF-8 locales. ## Before / After Before: generated `.mdx` reference files were written with the process default encoding. After: generated reference files are always written as UTF-8. ## Verification - `python -m py_compile docs/scripts/generate_python_reference.py`
Documentation Generator Scripts
Python Reference
Generate all split reference files into docs/mintlify/reference/python/:
uv run docs/scripts/generate_python_reference.py --output reference/python/
This produces client.mdx, collection.mdx, embedding-functions.mdx, search.mdx, and schema.mdx. There is no index page; /reference/python and /reference/python/index redirect to /reference/python/client. The file reference/python/where-filter.mdx is maintained by hand (Python DSL only) and is not overwritten by the script.
TypeScript Reference
Generate all split reference files into docs/mintlify/reference/typescript/:
bun run docs/scripts/generate_ts_reference.ts --output reference/typescript/
This produces client.mdx, collection.mdx, embedding-functions.mdx, search.mdx, and schema.mdx. There is no index page; /reference/typescript and /reference/typescript/index redirect to /reference/typescript/client. The file reference/typescript/where-filter.mdx is maintained by hand (TypeScript DSL only) and is not overwritten by the script.