Skip to content

Conversation

@ammar-agent
Copy link
Collaborator

@ammar-agent ammar-agent commented Dec 6, 2025

Converts all docs to .mdx, adds auto-generated first-class models table, and unifies doc generation.

Changes:

  • docs/*.mdx: Renamed all .md β†’ .mdx for consistent JSX comment handling
  • docs/models.mdx: First-class models table (generated from knownModels.ts)
  • scripts/gen_docs.ts: Unified generator for system prompt snippet + models table (replaces sync_system_prompt_docs.sh)
  • fmt.mk: Updated prettier patterns for .mdx; fmt-sync-docs now calls the unified generator
  • AGENTS.mdx: Added Model: openai.* section with gh CLI guidance

Generated with mux

@chatgpt-codex-connector
Copy link

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Repo admins can enable using credits for code reviews in their settings.

Mintlify parses all files as MDX internally, so we need to:
1. Use .mdx extension for files with generated content markers
2. Use JSX comments ({/* */}) for markers (HTML comments break MDX parsing)
3. Keep .md for all other doc files

Also DRY'd the gen_docs.ts script with a common syncDoc helper.
- Split model name and ID into separate columns
- Remove Provider column (redundant - visible in ID)
- DRY the table generation code
@ammar-agent ammar-agent changed the title πŸ€– docs: sync generated snippets πŸ€– docs: generate first-class models table from knownModels.ts Dec 6, 2025
@ammario ammario merged commit eb52bd4 into main Dec 6, 2025
18 checks passed
@ammario ammario deleted the generate-models-table-docs branch December 6, 2025 22:12
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