Commit f44537f
authored
Add Versioning section to Environments docs page (#668)
## Summary
Adds a **Versioning** section to the Environments page in the Mintlify
docs, right after the Base API URL it explains.
Integrator-facing policy it documents:
- The date in the base URL (`2025-10-13`) is the API's major version; a
pinned version's behavior doesn't change.
- Backwards-compatible (additive) changes land in the current version —
with tolerant-reader guidance (ignore unknown fields, handle new enum
values).
- Breaking changes ship only in a new dated version; existing versions
are unaffected and you upgrade on your own schedule.
- Deprecation: notice to the account contact email with migration steps,
and at least **three months** of continued support after notice.
The three-month window and notice mechanism deliberately match the MSA
(`mintlify/legal/msa.mdx` §7.1–7.2, three-month Migration Period) and
the existing "notify the account contact email" language used for
Service IP changes on the same page — no new commitments invented.
## Rendered page

## Test plan
- Rendered locally with `mint dev` (pinned CLI 4.2.284) — screenshot
above.
- `mint broken-links`: no new findings (pre-existing broken links in
untouched files only).
- Docs-only change; OpenAPI spec untouched.
Slack thread:
https://lightsparkgroup.slack.com/archives/D0AHLSKKV8R/p1783469743603179
---
🤖
[forked-diode](https://zeus.dev.dev.sparkinfra.net/#/arc?id=forked-diode)[(#1)](https://zeus.dev.dev.sparkinfra.net/#/instance?id=forked-diode)
| [Feedback](https://zeus.dev.dev.sparkinfra.net/feedback)
Original PR: #667
---------
Co-authored-by: Jeremy <jeremy@lightspark.com>1 parent b98f162 commit f44537f
1 file changed
Lines changed: 10 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
10 | 10 | | |
11 | 11 | | |
12 | 12 | | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
13 | 23 | | |
14 | 24 | | |
15 | 25 | | |
| |||
0 commit comments