Skip to content

Commit 53711e8

Browse files
committed
docs: define historical metadata ownership
1 parent 12eaaf5 commit 53711e8

1 file changed

Lines changed: 1 addition & 0 deletions

File tree

spec.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,7 @@ When `--version 4.3.5` is requested, `loadMetadataForVersion("4.3.5")` resolves
6666
### Data Layer Notes
6767

6868
- On load, component props are deduplicated by name (first entry wins).
69+
- Historical component API data comes only from the selected snapshot and that snapshot's own documentation. Missing English or Chinese descriptions may fall back to the latest major snapshot, but props and sub-component props never do. Runtime documentation backfill works on a shallow copy of the stored component, so resolving one component does not mutate the cached snapshot.
6970
- The extraction script handles `\|` (escaped pipes in markdown table cells) by replacing them with a placeholder before splitting. This ensures multi-value union types like `` `primary` \| `dashed` \| `link` `` are stored correctly as `` `primary` | `dashed` | `link` `` instead of being split across wrong columns.
7071
- Each version file contains both `en` and `zh` descriptions, keyed by language
7172
- `semantic` data extracted from `components/*/demo/_semantic.tsx` files

0 commit comments

Comments
 (0)