Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

docs(dense): restore bestPractices count parity for Timestamp (#4543)

Joeyac4a27e50ef7
diff --git a/packages/core/src/Timestamp/Timestamp.doc.mjs b/packages/core/src/Timestamp/Timestamp.doc.mjs
index 7770927017..22d46d9640 100644
--- a/packages/core/src/Timestamp/Timestamp.doc.mjs
+++ b/packages/core/src/Timestamp/Timestamp.doc.mjs
@@ -168,12 +168,14 @@ export const docsDense = {
{guidance: true, description: 'Auto format in feeds and lists; recent shows relative, older shows date_time.'},
{guidance: true, description: 'Consistent formatting within the same list or table column.'},
{guidance: true, description: 'isTimezoneShown for multi-timezone audiences.'},
- {guidance: true, description: 'tooltipEntries to compare zones on hover; label each entry once more than one zone is shown.'},
+ {guidance: true, description: 'tooltipEntries to compare zones when the reader time and event zone both matter.'},
+ {guidance: true, description: 'Label each entry once a tooltip shows more than one zone; a bare abbreviation is not always recognizable (Tokyo renders "GMT+9", not "JST").'},
{guidance: true, description: 'isLive for dashboards so relative time stays current.'},
- {guidance: false, description: 'Don\'t use fixed-offset ids like "EST" for timezoneID; they skip DST. Use region ids like "America/New_York".'},
{guidance: false, description: 'Don\'t show raw Unix timestamps or ISO strings; always use Timestamp.'},
{guidance: false, description: 'Avoid system_* formats in user-facing UI; those are for dev tools and logs.'},
{guidance: false, description: 'Don\'t disable tooltip on relative timestamps; users expect the full date on hover.'},
+ {guidance: false, description: 'Don\'t stack many zones in one tooltip; it caps at 300px and long labels wrap. Two or three read well.'},
+ {guidance: false, description: 'Don\'t use fixed-offset ids like "EST" for timezoneID; they skip DST. Use region ids like "America/New_York".'},
],
},
propDescriptions: {