Skip to content

Commit 1b4a916

Browse files
authored
[Docs] Update new design language page for v12.0.0-beta.2 release guidance (Shopify#10816)
> [!Important] > Do not merge until `v12.0.0-beta.2` released ### WHY are these changes introduced? Updates content on `/new-design-language` page for the `v12.0.0-beta.2` release. Because our migration guidance isn't published on our site yet, I've linked to the guidance for migrations from our `next` branch. ### WHAT is this pull request doing? Updates documentation specifically for `v12.0.0-beta.2` release. <details> <summary>What's new page update</summary> <img src="https://github.com/Shopify/polaris/assets/26749317/4328ab19-651a-415c-baec-e7fa694288b7" alt="What's new page update"> </details> <details> <summary>Timeline update</summary> <img src="https://github.com/Shopify/polaris/assets/26749317/9e7f6b57-11ad-4900-a788-bcfe4ae2a01b" alt="Timeline update"> </details> <details> <summary>Want to dive in early update</summary> <img src="https://github.com/Shopify/polaris/assets/26749317/79e6092c-9fae-4f5d-9095-af899540c9e2" alt="Want to dive in early update"> </details> ### How to 🎩 🖥 [Local development instructions](https://github.com/Shopify/polaris/blob/main/README.md#local-development) 🗒 [General tophatting guidelines](https://github.com/Shopify/polaris/blob/main/documentation/Tophatting.md) 📄 [Changelog guidelines](https://github.com/Shopify/polaris/blob/main/.github/CONTRIBUTING.md#changelog) ### 🎩 checklist - [ ] Tested on [mobile](https://github.com/Shopify/polaris/blob/main/documentation/Tophatting.md#cross-browser-testing) - [ ] Tested on [multiple browsers](https://help.shopify.com/en/manual/shopify-admin/supported-browsers) - [ ] Tested for [accessibility](https://github.com/Shopify/polaris/blob/main/documentation/Accessibility%20testing.md) - [ ] Updated the component's `README.md` with documentation changes - [x] [Tophatted documentation](https://github.com/Shopify/polaris/blob/main/documentation/Tophatting%20documentation.md) changes in the style guide
1 parent 6db4ec7 commit 1b4a916

File tree

2 files changed

+21
-5
lines changed

2 files changed

+21
-5
lines changed

polaris.shopify.com/content/new-design-language/index.md

Lines changed: 20 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ Refer to the table below for the timeline of each milestone:
3131
| Milestone | Version | Date |
3232
| ----------------------------------------------------------------- | ------------------------------------------- | ----------------------------------------- |
3333
| Initial beta release, update to early adopters who want to opt in | `12.0.0-beta.0` | July 26 |
34-
| Incremental beta releases | `12.0.0-beta.1`<br/>`12.0.0-beta.2`<br/>etc | July – September |
34+
| Incremental beta releases | `12.0.0-beta.1`<br/>`12.0.0-beta.2`<br/>etc | July – Early October |
3535
| Polaris release with stable API, robust documentation and tooling | `12.0.0` | Early October<sup>[\*](#footnote-1)</sup> |
3636

3737
<sup id="footnote-1" style="font-size:var(--p-font-size-275); line-height:
@@ -66,18 +66,34 @@ You will need to review your app's UI and manually patch fixes.
6666
To prepare for Polaris version 12 make sure you're on the latest version 11.
6767
It's quick to update from v10 to v11 with our [migrator tool](https://polaris.shopify.com/tools/polaris-migrator) and [migration guide](https://github.com/Shopify/polaris/blob/main/documentation/guides/migrating-from-v10-to-v11.md).
6868

69-
To install the v12 beta version run the following command:
69+
To install the v12 beta version that **does not require migrations** run the following command:
7070

7171
```sh
72-
npm install @shopify/polaris@beta
72+
npm install @shopify/polaris@12.0.0-beta.0
7373
```
7474

7575
Or, if you prefer yarn, use the following command instead:
7676

7777
```sh
78-
yarn add @shopify/polaris@beta
78+
yarn add @shopify/polaris@12.0.0-beta.0
7979
```
8080

81+
To install the v12 beta version that **requires migrations** run the following command:
82+
83+
```sh
84+
npm install @shopify/polaris@12.0.0-beta.2
85+
```
86+
87+
Or, if you prefer yarn, use the following command instead:
88+
89+
```sh
90+
yarn add @shopify/polaris@12.0.0-beta.2
91+
```
92+
93+
The migration guidance for upgrading from Polaris version 11 to version 12 is not yet available on our website. However, you can refer to the migration guide available in our codebase for detailed instructions if you are using the `12.0.0-beta.2` release. You can access the migration guide [here](https://github.com/Shopify/polaris/blob/next/polaris.shopify.com/content/version-guides/migrating-from-v11-to-v12.md). It provides step-by-step guidance to help you smoothly transition your codebase for the `12.0.0-beta.2` release.
94+
95+
Please note that the migration guide specifically covers the upgrade process from Polaris version 11 to version 12 beta release. Keep in mind that the guidance on our website may be updated in the future, so it's a good idea to stay informed about any new announcements or documentation releases related to Polaris version 12.
96+
8197
To assist you, we have prepared a collection of tips, documentation, and our own experience to help you on this early journey.
8298

8399
## Design philosophy

polaris.shopify.com/pages/whats-new.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ export const getStaticProps: GetStaticProps<
5555
posts.unshift({
5656
title: 'Shopify Polaris v12 beta',
5757
description:
58-
'You can access the beta now or simply wait for the stable release in September.',
58+
'You can access the beta now or simply wait for the stable release in early October.',
5959
slug: '/new-design-language',
6060
imageUrl: '/images/updates/uplift-beta@2x.png',
6161
});

0 commit comments

Comments
 (0)