|
| 1 | +## 4.87.0 |
| 2 | +**`(feat):`** Add new `docs.yml` metadata fields for controlling dynamically generated OG images: |
| 3 | +`og:dynamic:text-color`, `og:dynamic:background-color`, `og:dynamic:logo-color` |
| 4 | +(`dark` | `light`), and five visibility toggle flags (`og:dynamic:show-logo`, |
| 5 | +`og:dynamic:show-section`, `og:dynamic:show-description`, `og:dynamic:show-url`, |
| 6 | +`og:dynamic:show-gradient`). |
| 7 | +Also fixes a pre-existing gap where `og:dynamic` and `og:background-image` were |
| 8 | +missing from the Zod `MetadataConfig` schema, causing `fern check` to reject them. |
| 9 | + |
| 10 | + |
| 11 | +**`(fix):`** Populate `apiNameToId` in `fern docs dev` so MDX widgets that resolve APIs by |
| 12 | +user-facing name (e.g. `<MergeSupportedFieldsByIntegrationWidget apiName="hris_v2" ... />`) |
| 13 | +work in local preview. Previously the preview server hardcoded this mapping to |
| 14 | +`{}`, causing such widgets to throw `MergeWidgetResolutionError` and render the |
| 15 | +affected pages as 500 Internal Server Error. |
| 16 | + |
| 17 | + |
| 18 | +**`(chore):`** Emit non-fatal warnings during `fern check` / `fern docs dev` when `docs.yml` |
| 19 | +metadata settings silently conflict. Covered cases: |
| 20 | +- `og:dynamic: true` combined with `og:image` or `twitter:image` (the static |
| 21 | + images only apply to the homepage once dynamic generation is enabled). |
| 22 | +- `og:dynamic:*` sub-settings or `og:background-image` set without |
| 23 | + `og:dynamic: true` (they are ignored). |
| 24 | +- `og:dynamic:logo-color` set with `og:dynamic:show-logo: false` (no effect). |
| 25 | +- `og:image:width` / `og:image:height` set without `og:image`. |
| 26 | +- `og:dynamic:text-color` equal to `og:dynamic:background-color` |
| 27 | + (text is invisible). |
| 28 | + |
| 29 | + |
1 | 30 | ## 4.86.2 |
2 | 31 | **`(fix):`** Gate the consolidation of top-level OpenAPI servers into a single multi-URL |
3 | 32 | environment behind a new setting, `multi-server-strategy`, with values |
|
0 commit comments