diff --git a/apps/docs/content/components/River/index.mdx b/apps/docs/content/components/River/index.mdx index b4edb4c36..f5ca00812 100644 --- a/apps/docs/content/components/River/index.mdx +++ b/apps/docs/content/components/River/index.mdx @@ -149,7 +149,7 @@ Some examples of when to use a river breakout: -The headline in the river component must always be present, but the supplemental content is optional. +The leading content in a river breakout component must always be present, but the trailing content is optional. @@ -157,18 +157,18 @@ The headline in the river component must always be present, but the supplemental alt="" src="https://github.com/primer/brand/assets/2313998/433b1fba-4505-452b-8f8c-7cda69cc316d" /> - Exclude the supplemental content if it's not needed. + Always provide leading content. - Don't exclude the headline. + Don't exclude the leading content. -Limit supplemental content to a maximum of 500 characters or two timeline items to avoid overwhelming the user and disrupting the layout's balance. +Limit trailing content to a maximum of 500 characters (or two timeline items) to avoid overwhelming the user and disrupting the layout's balance. @@ -176,16 +176,19 @@ Limit supplemental content to a maximum of 500 characters or two timeline items alt="" src="https://github.com/primer/brand/assets/175638/c5879e94-09c3-4494-aa42-87543570dfb4" /> - Limit supplemental timeline content to two items. + + Limit high character counts in trailing content to preserve visual + balance. + - Avoid unbalanced river breakout content. + Avoid using high character counts in trailing content. -{' '} + ### River story scroll diff --git a/apps/docs/scripts/components-with-animation.js b/apps/docs/scripts/components-with-animation.js index c5004cc7d..98574c8d0 100644 --- a/apps/docs/scripts/components-with-animation.js +++ b/apps/docs/scripts/components-with-animation.js @@ -9,11 +9,11 @@ export const supportedComponents = [ 'Image', 'Label', 'Pillar', - 'SectionIntro', 'Stack', + 'SectionIntro', + 'Statistic', 'Testimonial', 'Text', - 'Statistic', 'Timeline', 'Animate', 'River',