Revert and rephrase landmarks guideline

Amsterdam · Sep 4, 2024 · bbb73e9 · bbb73e9
1 parent bbfe796
commit bbb73e9
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 6 deletions.
diff --git a/storybook/src/components/Accordion/Accordion.docs.mdx b/storybook/src/components/Accordion/Accordion.docs.mdx
@@ -23,13 +23,13 @@ If you want the contents of an accordion section to appear initially, pass the `
 
 <Canvas of={AccordionStories.ExpandedByDefault} />
 
-### Improve semantics
+### Limit the amount of accessibility landmarks
 
-By default, an Accordion Section renders a `section` element in HTML.
-Having many Accordion Sections on your page can lead to too many landmark regions, confusing screen reader users.
-In that case, use `sectionAs="div"`.
+An Accordion Section renders a `section` element in HTML by default.
+Each of them introduces a landmark region, but having many of them on a page can confuse screen reader users.
+Consider using general `div` elements instead through `sectionAs="div"`.
 
-<Canvas of={AccordionStories.ImproveSemantics} />
+<Canvas of={AccordionStories.ReduceLandmarks} />
 
 ### Technical considerations
 

diff --git a/storybook/src/components/Accordion/Accordion.stories.tsx b/storybook/src/components/Accordion/Accordion.stories.tsx
@@ -59,7 +59,7 @@ export const ExpandedByDefault: Story = {
   },
 }
 
-export const ImproveSemantics: Story = {
+export const ReduceLandmarks: Story = {
   args: {
     sectionAs: 'div',
     children: [