diff --git a/packages/docs/design-docs/ux-writing/index.mdx b/packages/docs/design-docs/ux-writing/index.mdx index c4be11bfb..7bddb91ed 100644 --- a/packages/docs/design-docs/ux-writing/index.mdx +++ b/packages/docs/design-docs/ux-writing/index.mdx @@ -2,7 +2,7 @@ import CardGrid from '@components/Card/CardGrid'; import LandingCard from '@components/Card/LandingCard'; import Icon from '@components/icons/Icon'; -# UX writing guide +# UX Writing Guide -The purpose of the **BigCommerce UX writing guide** is to present a consistent, coherent and competent voice to BigCommerce merchants and their shoppers as it relates to in-product, customer-facing communication, aka microcopy. +The purpose of the **BigCommerce UX Writing Guide** is to present a consistent, coherent and competent voice to BigCommerce merchants and their shoppers as it relates to in-product, customer-facing communication, aka microcopy. -Writers, researchers, designers and developers, both internal and external, who have a hand in designing BigCommerce products can refer to this guide anytime there’s a question about the writing. +Writers, researchers, designers and developers, both internal and external, who have a hand in designing BigCommerce products can refer to this guide anytime there’s a question about UX writing. - Not sure if you need a period at the end of a heading? diff --git a/packages/docs/design-docs/ux-writing/status-messages.mdx b/packages/docs/design-docs/ux-writing/status-messages.mdx index a03d9926c..7948851b0 100644 --- a/packages/docs/design-docs/ux-writing/status-messages.mdx +++ b/packages/docs/design-docs/ux-writing/status-messages.mdx @@ -1,6 +1,6 @@ import { Donts, Dos } from '@components/big-design/DosAndDonts'; -# Status messages +# Status Messages Status messages help the user to understand what is happening in the application. Their common instances are success, warning and error messages. diff --git a/packages/docs/design-docs/ux-writing/the-basics.mdx b/packages/docs/design-docs/ux-writing/the-basics.mdx index ba0faf523..6b6537324 100644 --- a/packages/docs/design-docs/ux-writing/the-basics.mdx +++ b/packages/docs/design-docs/ux-writing/the-basics.mdx @@ -2,7 +2,7 @@ import { ComparisonTable } from '@components/big-design/ComparisonTable'; import { Donts, Dos, DosAndDonts } from '@components/big-design/DosAndDonts'; import Icon from '@components/icons/Icon'; -# The basics +# The Basics ## Voice and tone @@ -70,7 +70,7 @@ Merchants who use BigCommerce come from a wide range of different social and eth The language we use inside our products should take into account the diversity of our users. To that end, communicate in such a way that is inclusive, being careful to avoid culturally ingrained biases that, actively or passively, exclude certain groups. -The goal of this section of the UX writing guide is to give you a quick gloss on how to remove non-inclusive terms and phrases from the discourse of ecommerce. +The goal of this section of the UX Writing Guide is to give you a quick gloss on how to remove non-inclusive terms and phrases from the discourse of ecommerce. ### What is inclusive language? diff --git a/packages/docs/design-docs/ux-writing/writing-for-mobile.mdx b/packages/docs/design-docs/ux-writing/writing-for-mobile.mdx index 3b40e528b..d4f6d0e4d 100644 --- a/packages/docs/design-docs/ux-writing/writing-for-mobile.mdx +++ b/packages/docs/design-docs/ux-writing/writing-for-mobile.mdx @@ -1,4 +1,4 @@ -# Writing for mobile +# Writing for Mobile When writing for the mobile app: