Skip to content

docs(site): promote the live Roadmap and docs sync to main - #598

Merged
amirkhan-ak-sf merged 3 commits into
mainfrom
develop
Sep 24, 2026
Merged

amirkhan-ak-sf merged 3 commits into
mainfrom
develop

Conversation

@amirkhan-ak-sf

Copy link
Copy Markdown
Collaborator

Promotes develop to main. Merging publishes the docs site (the docs.yml workflow runs on pushes to main touching website/).

Included

All CI checks passed on #594.

tbolis-at-mulesoft and others added 3 commits September 24, 2026 14:25
…recent issues (#594)

* docs(roadmap): load milestone status live from GitHub, keep the snapshot as fallback (#592)

The Roadmap page rendered a build-time snapshot that only refreshed on pushes
to main. RoadmapPhase/RoadmapUpdated are now a client component that refetches
milestones and issues from the public GitHub REST API after hydration (four
requests, no token, cached 30 min in localStorage) and fall back to the
snapshot on any failure. docs.yml rebuilds every 6 hours from main so the
snapshot stays fresh for no-JS visitors and search.

* docs(site): sync pages with issues filed since the restructure (#593)

- Roadmap: phase prose covers every open milestone topic, including the
  TypeSafe Jev epic and gateway semantic caching/routing; the non-goal now
  separates gateway semantic caching from client-side caching.
- Telemetry & gateway-identity: known limitation for provider/model names
  reading as substituted (#586); semantic caching & routing as Roadmap.
- Frameworks: TypeSafe Jev as a Roadmap decision model, not OpenAI-compatible.
- Gateway identity: request_id is the upstream provider's id (#542).

* docs(site): correct budget headers, config coverage and error tree against the code (#593)

- Budget: success/403 carry the prose x-llm-proxy-ratelimit header, only the
  429 carries x-token-*; Budget parses both and stays None until observed.
- Configuration: auth providers section (the AuthProvider link pointed at the
  unrelated Identity page), DONKEY_LLM_PROXY_KEY, correlation header
  overrides, and a Behaviour table (timeout, retries, model substitution,
  registry cache, DONKEY_NO_CACHE).
- Errors: the tree lists BudgetReserveReached, ModelSubstituted and the tool
  access / registry / publishing errors.
- Feature overview: the framework-free client card links to the Quickstart,
  not the OpenAI Agents SDK page.
- Telemetry: last_call also carries identity and usage fields.
@amirkhan-ak-sf amirkhan-ak-sf added documentation Improvements or additions to documentation area:docs Docs site, README, verified-apis labels Sep 24, 2026
@amirkhan-ak-sf
amirkhan-ak-sf merged commit 4b81cab into main Sep 24, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs Docs site, README, verified-apis documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants