Skip to content

chore: regenerate docs navigation when generated SDK pages change - #1043

Merged
louisgv merged 1 commit into
mainfrom
devin/1789700469-docs-nav-workflow
Sep 18, 2026
Merged

louisgv merged 1 commit into
mainfrom
devin/1789700469-docs-nav-workflow

Conversation

@devin-ai-integration

Copy link
Copy Markdown
Contributor

Summary

The docs site (openrouter.ai/docs/client-sdks/typescript) mounts this repo's docs/docs.json via Mintlify sourceRef. Its navigation.pages is only rebuilt by scripts/gen-docs-nav.sh inside speakeasy_run_on_pr.yaml, which triggers on .speakeasy/in.openapi.yaml changes. The Speakeasy "Update SDK" PRs add new docs/sdks/<tag>/README.mdx pages without touching that file, so the nav has been stale since July: decisions, interns, containers, scim and vault pages exist but are unreachable (the decisions page renders as a 404 on the docs site).

  • Adds .github/workflows/docs-nav.yaml, a copy of the python-sdk workflow, which runs gen-docs-nav.sh on PRs touching docs/sdks/** and auto-commits docs.json.
  • Runs the script once now so the nav picks up the five missing pages (and drops the removed betaanalytics entry).

Link to Devin session: https://openrouter.devinenterprise.com/sessions/3f706d7e7e6f4a1dbe42eef374519a68
Open in Devin Desktop: https://openrouter.devinenterprise.com/desktop/session/3f706d7e7e6f4a1dbe42eef374519a68?variant=devin
Requested by: @christineschen

@mintlify

mintlify Bot commented Sep 18, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
openrouter-production 🟢 Ready View Preview Sep 18, 2026, 3:03 AM

@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR that start with 'DevinAI' or '@devin'.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

Original prompt from Christine

SYSTEM:
<latest_message>
Christine Chen (U0B8QM7RKLL) [ts=1789686258.156009]: @Devin look into why ts and python sdks aren't enabled
</latest_message>

=== BEGIN THREAD HISTORY (in #proj-jev) ===
Abhinav Pola (U090K0G7JF3) [ts=1789682735.294299]: LETSSS GOOO
&gt; Real request works. typesafe/jev-1.13 → HTTP 200, provider TypeSafe, one noul answer (0.97), usage 289 in / 21 out, cost 0.000012138 (exactly 289 × 4.2e-8, so pricing is live). Same result for the dated permaslug.

Jacky Liang (U0AUY9BQV18) [ts=1789682862.355109]: this is on openrouter yeah?

Abhinav Pola (U090K0G7JF3) [ts=1789682867.572409]: yup

Abhinav Pola (U090K0G7JF3) [ts=1789682874.528679]: private endpoint (only our org can use it)

Ayush Patel (U0B8L6RNMA9) [ts=1789683251.473799]: aside i wonder why they opted for that model naming, i hope they dont just release a shit ton of minor versions

they do jev-latest in their docs maybe to point people to not use jev-1.13 specifically

ATTACHMENT:"https://openrouter.devinenterprise.com/attachments/f9f4910c-8f9f-44d9-af01-1e4b663826f9/image.png"

Louis Vichy (U0ACWETHNLT) [ts=1789683500.173969]: @Abhinav Pola btw what's the SDK looking like?

Louis Vichy (U0ACWETHNLT) [ts=1789683518.815939]: do we have the SDK gen for alpha API hooked up or is that... a separate hurdle

Abhinav Pola (U090K0G7JF3) [ts=1789683698.072549]: just saw this <https://openrouter.ai/docs/client-sdks/go/sdks/decisions/README`#`decisions>

Louis Vichy (U0ACWETHNLT) [ts=1789685494.257079]: Weird, so go works, but TS and Python isn't?..

Abhinav Pola (U090K0G7JF3) [ts=1789685510.082919]: i'm not sure what went wrong

Abhinav Pola (U090K0G7JF3) [ts=1789685522.539739]: docs arent showing up either

Louis Vichy (U0ACWETHNLT) [ts=1789685523.518409]: cc @Christine Chen do you know why the TS and Python are not being enabled

Christine Chen (U0B8QM7RKLL) [ts=1789686242.551129]: hmm I'm not sure, t... (742 chars truncated...)

@mintlify

mintlify Bot commented Sep 18, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
openrouter-staging 🟢 Ready View Preview Sep 18, 2026, 3:03 AM

@louisgv
louisgv marked this pull request as ready for review September 18, 2026 03:02
@louisgv
louisgv merged commit 7a1a658 into main Sep 18, 2026
2 of 3 checks passed
@louisgv
louisgv deleted the devin/1789700469-docs-nav-workflow branch September 18, 2026 03:02
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