readme

README.md

@@ -54,22 +54,37 @@ With the above in mind, a fresh clone of the Simple Design System Figma file sho
 
 All components and styles are in [src/ui](./src/ui). Within that directory, code is broken down into a few categories.
 
-- [compositions](./src/ui/compositions/)
-  - Example arrangements of primitive components to demonstrate how you might use SDS to build a responsive website.
-- [hooks](./src/ui/hooks/)
-  - Custom React hook definitions
-- [icons](./src/ui/icons/)
-  - All icon components. Automatically generated by [scripts/icons](./scripts/icons)
-- [images](./src/ui/images/)
-  - Placeholder images.
-- [layout](./src/ui/layout/)
-  - Layout components. Crucial to SDS layouts, but do not have analagous component in Figma.
-- [primitives](./src/ui/primitives/)
-  - The main component library. SDS primitives can't be reduced further into sub components.
-- [providers](./src/ui/providers/)
-  - Custom React provider definitions
-- [utils](./src/ui/utils/)
-  - Custom utilities and utility components
+### [compositions](./src/ui/compositions/)
+
+Example arrangements of primitive components to demonstrate how you might use SDS to build a responsive website.
+
+### [hooks](./src/ui/hooks/)
+
+Custom React hook definitions
+
+### [icons](./src/ui/icons/)
+
+All icon components. Automatically generated by [scripts/icons](./scripts/icons)
+
+### [images](./src/ui/images/)
+
+Placeholder images.
+
+### [layout](./src/ui/layout/)
+
+Layout components. Crucial to SDS layouts, but do not have analagous component in Figma.
+
+### [primitives](./src/ui/primitives/)
+
+The main component library. SDS primitives can't be reduced further into sub components.
+
+### [providers](./src/ui/providers/)
+
+Custom React provider definitions
+
+### [utils](./src/ui/utils/)
+
+Custom utilities and utility components
 
 All Code Connect docs and Storybook stories follow the same categorization are defined in [src/figma](./src/figma) and [src/stories](./src/stories).