diff --git a/packages/storybook/src/docs/capitalization-assets/banner.png b/packages/storybook/src/docs/capitalization-assets/banner.png new file mode 100644 index 0000000000..212dc26e98 Binary files /dev/null and b/packages/storybook/src/docs/capitalization-assets/banner.png differ diff --git a/packages/storybook/src/docs/capitalization-assets/breadcrumb.png b/packages/storybook/src/docs/capitalization-assets/breadcrumb.png new file mode 100644 index 0000000000..a84036f74f Binary files /dev/null and b/packages/storybook/src/docs/capitalization-assets/breadcrumb.png differ diff --git a/packages/storybook/src/docs/capitalization-assets/chip.png b/packages/storybook/src/docs/capitalization-assets/chip.png new file mode 100644 index 0000000000..72fd829349 Binary files /dev/null and b/packages/storybook/src/docs/capitalization-assets/chip.png differ diff --git a/packages/storybook/src/docs/capitalization-assets/container.png b/packages/storybook/src/docs/capitalization-assets/container.png new file mode 100644 index 0000000000..77c8bcb903 Binary files /dev/null and b/packages/storybook/src/docs/capitalization-assets/container.png differ diff --git a/packages/storybook/src/docs/capitalization-assets/dialog.png b/packages/storybook/src/docs/capitalization-assets/dialog.png new file mode 100644 index 0000000000..4c1aaa32ba Binary files /dev/null and b/packages/storybook/src/docs/capitalization-assets/dialog.png differ diff --git a/packages/storybook/src/docs/capitalization-assets/drawer.png b/packages/storybook/src/docs/capitalization-assets/drawer.png new file mode 100644 index 0000000000..d94d1ef0ed Binary files /dev/null and b/packages/storybook/src/docs/capitalization-assets/drawer.png differ diff --git a/packages/storybook/src/docs/capitalization-assets/menu.png b/packages/storybook/src/docs/capitalization-assets/menu.png new file mode 100644 index 0000000000..b01ca44aab Binary files /dev/null and b/packages/storybook/src/docs/capitalization-assets/menu.png differ diff --git a/packages/storybook/src/docs/capitalization-assets/stepper.png b/packages/storybook/src/docs/capitalization-assets/stepper.png new file mode 100644 index 0000000000..19ea3686a3 Binary files /dev/null and b/packages/storybook/src/docs/capitalization-assets/stepper.png differ diff --git a/packages/storybook/src/docs/capitalization-assets/tabs.png b/packages/storybook/src/docs/capitalization-assets/tabs.png new file mode 100644 index 0000000000..928668c48f Binary files /dev/null and b/packages/storybook/src/docs/capitalization-assets/tabs.png differ diff --git a/packages/storybook/src/docs/capitalization-assets/tile.png b/packages/storybook/src/docs/capitalization-assets/tile.png new file mode 100644 index 0000000000..d305028e4d Binary files /dev/null and b/packages/storybook/src/docs/capitalization-assets/tile.png differ diff --git a/packages/storybook/src/docs/capitalization-assets/tree-view.png b/packages/storybook/src/docs/capitalization-assets/tree-view.png new file mode 100644 index 0000000000..5ea62acf28 Binary files /dev/null and b/packages/storybook/src/docs/capitalization-assets/tree-view.png differ diff --git a/packages/storybook/src/docs/capitalization.mdx b/packages/storybook/src/docs/capitalization.mdx new file mode 100644 index 0000000000..a841db56da --- /dev/null +++ b/packages/storybook/src/docs/capitalization.mdx @@ -0,0 +1,98 @@ +import { Meta } from '@storybook/addon-docs/blocks'; +import bannerImage from './capitalization-assets/banner.png'; +import breadcrumbImage from './capitalization-assets/breadcrumb.png'; +import chipImage from './capitalization-assets/chip.png'; +import containerImage from './capitalization-assets/container.png'; +import dialogImage from './capitalization-assets/dialog.png'; +import drawerImage from './capitalization-assets/drawer.png'; +import menuImage from './capitalization-assets/menu.png'; +import stepperImage from './capitalization-assets/stepper.png'; +import tileImage from './capitalization-assets/tile.png'; +import tabsImage from './capitalization-assets/tabs.png'; +import treeViewImage from './capitalization-assets/tree-view.png'; + + + +# Capitalization + +## Overview + +In general, use the following capitalization conventions to ensure consistency +across the interface: + +- ALL CAPS for table headers. +- Title Case for dialog titles. +- Sentence case for all other UI text. + +## Component Cases + +### Banner + +The title of a banner should use sentence case along with the rest of the +elements. + +Banner capitalization example + +### Breadcrumb + +Breadcrumbs should use title case. + +Breadcrumb capitalization example + +### Card + +Cards should use all caps. + +Card capitalization example + + +### Chip + +Chips should use title case. + +Chip capitalization example + +### Container + +Containers should use sentence case for all elements. + +Container capitalization example + +### Dialog + +Dialog titles should use title case. Content inside the dialog should use +sentence case. + +Dialog capitalization example + +### Drawer + +Drawer titles should be title case. Other elements should be sentence case. + +Drawer capitalization example + +### Menu + +Menus group headers should be all caps. The rest of the elements should be +sentence case. + +Menu capitalization example + +### Stepper + +Stepper titles should be title case, subtitles should be sentence case. + +Stepper capitalization example + +### Tabs + +Tabs in applications should be title case. Tabs in dialogs and drawers should +be sentence case. + +Tabs capitalization example + +### Tree View + +Tree view should use sentence case for all elements and sub elements. + +Tree view capitalization example \ No newline at end of file