final updates

Author: chloerice

polaris.shopify.com/content/getting-started/index.md

@@ -1,7 +1,7 @@
 ---
 title: Getting Started
 navTitle: Getting started
-description: 'Polaris is the design system for the Shopify admin. If you’re just starting out with Polaris, here’s a list of recommended resources and guidance to get you started:'
+description: 'Polaris is the design system for the Shopify admin. If you’re just starting out with Polaris, here’s a list of recommended resources and guidance to get you started.'
 keywords:
   - about
   - polaris
@@ -18,32 +18,31 @@ order: 1
 icon: HintMajor
 ---
 
-Polaris is the design system for the Shopify admin. If you’re just starting out with Polaris, here’s a list of recommended resources and guidance to get you started:
-
-### Design resources
+## Design resources
 
 Shopify provides [Figma community resources](https://www.figma.com/@Shopify) for Polaris components, styles, and icons. If you are new to Figma, check out our [onboarding guide](https://www.figma.com/community/file/994263185745279952), or open Figma and start designing with the resources below:
 
 - [Component UI kit](https://www.figma.com/community/file/1111360433678236702)
 - [Style Library](https://www.figma.com/community/file/1111359207966840858)
 - [Icon Library](https://www.figma.com/file/mMHFt3kEDNjLMZWowi6gnt/Polaris-Icons?node-id=753%3A2)
 
-### Develop resources
+## Development resources
+
+The [Shopify/polaris GitHub repo](https://github.com/Shopify/polaris) is an open-source monorepo made up of NPM packages, VSCode extensions, Figma plugins, and websites. To get started, install and use the Polaris:
 
-The [shopify/polaris repo](https://github.com/Shopify/polaris) is an open-source monorepo made up of NPM packages, VSCode extensions, Figma plugins and websites. To get started:
+- [React components](https://github.com/Shopify/polaris/tree/main/polaris-react#using-the-react-components)
+- [Design Tokens](https://github.com/Shopify/polaris/tree/main/polaris-tokens#installation)
+- [VS Code extension](https://marketplace.visualstudio.com/items?itemName=Shopify.polaris-for-vscode)
 
-- [Install and use the React components](https://github.com/Shopify/polaris/tree/main/polaris-react#using-the-react-components)
-- [Polaris token usage](https://github.com/Shopify/polaris/tree/main/polaris-tokens#installation)
-- [Polaris for VS Code extension]
+## Tutorials
 
-### Tutorials
+### [Build a Shopify app](https://shopify.dev/apps/getting-started/create)
 
-[Build a Shopify app](https://shopify.dev/apps/getting-started/create)
 In this tutorial, you'll create an app that merchants can access in the Shopify admin. You'll use an app initialization command that generates starter code for building your app, and sets up your development environment so that you can work with your app using [Shopify CLI](https://shopify.dev/apps/tools/cli).
 
 Your app will use Polaris and [App Bridge](https://shopify.dev/apps/tools/app-bridge) while following the [App Design Guidelines](https://shopify.dev/apps/design-guidelines).
 
-### Next
+## Expand your knowledge
 
 Polaris provides foundational design guidance for creating good merchant experiences. Here are some recommended resources to:
 

polaris.shopify.com/content/getting-started/patterns-components-and-tokens.md

@@ -7,6 +7,12 @@ keywords:
 order: 0
 ---
 
+## What’s the Shopify admin?
+
+Merchants set up their store, configure settings, and manage their business using the admin. It includes core aspects of the merchant’s business, including orders, products, and customers.
+
+![Partial screenshots of the admin in mobile and web](/images/getting-started/polaris-101/[email protected])
+
 ## What is Polaris?
 
 Polaris is the design system for the Shopify admin. It’s the shared language that guides how we build high-quality merchant experiences.
@@ -17,14 +23,8 @@ The design system is made up of design guidance, code libraries, development opi
 
 Polaris is used both internally at Shopify and externally by app developers and designers.
 
-## What’s the Shopify admin?
-
-Merchants set up their store, configure settings, and manage their business using the admin. It includes core aspects of the merchant’s business, including orders, products, and customers.
-
 ## What are Shopify apps?
 
 The admin includes installable apps that are distributed through the Shopify App Store. They enable merchants to add functionality to their stores without leaving the familiar environment of the admin.
 
 By building with Polaris and [App Bridge](https://shopify.dev/apps/tools/app-bridge) and following the [App Design Guidelines](https://shopify.dev/apps/design-guidelines), you'll create a streamlined experience with the rest of the Shopify admin.
-
-![Partial screenshots of the admin in mobile and web](/images/getting-started/polaris-101/[email protected])