From fdacf03423ceca49cf70b55f34b9c83b4dce28d7 Mon Sep 17 00:00:00 2001 From: Megan Date: Fri, 7 Feb 2025 10:22:46 -0500 Subject: [PATCH 1/5] (feat): Add "downgrade to word list" --- packages/paste-website/src/data/word-list.json | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/paste-website/src/data/word-list.json b/packages/paste-website/src/data/word-list.json index 8bf5dd42d2..0b828f8fc2 100644 --- a/packages/paste-website/src/data/word-list.json +++ b/packages/paste-website/src/data/word-list.json @@ -27,6 +27,7 @@ "disabled": "Use for conveying a status where the entity or feature is preventing a broader feature to function. \n This is a more technical word that could be perceived as jargon, so consider content best practices (simple words!) and your audience. Use the less technical term 'off' if it won't hinder comprehension or accuracy, or if you're writing for a less technical audience (like marketers).", "dismiss": "Avoid. Use 'close' instead.", "done": "Avoid. Use 'finish' or 'close' instead, depending on the use case. Actions more closely describe what will happen when the user clicks the button.", + "downgrade": "Avoid using this.", "download": "Use as a call to action when a user need to copy data from Twilio to a computer system", "duplicate": "Use when allowing user to create a replica of an existing item.", "easy / easily": "Avoid. This contains a value judgement and can make users feel dumb if it doesn't feel easy to them.", From 4c75f67cb29ad7248cebf8d51992b76d5ca174e9 Mon Sep 17 00:00:00 2001 From: Megan Date: Fri, 7 Feb 2025 10:27:53 -0500 Subject: [PATCH 2/5] Update word-list.json --- packages/paste-website/src/data/word-list.json | 1 + 1 file changed, 1 insertion(+) diff --git a/packages/paste-website/src/data/word-list.json b/packages/paste-website/src/data/word-list.json index 0b828f8fc2..80ea796095 100644 --- a/packages/paste-website/src/data/word-list.json +++ b/packages/paste-website/src/data/word-list.json @@ -75,6 +75,7 @@ "success/successfully": "Avoid because it is almost always redundant. For example, instead of saying 'Your account was sucessfully created.' we can say 'Your account was created.'", "team member": "Don't use 'teammate' or 'team mate'", "thank you": "Don't use when users completed something they'd do otherwise. Only use when we've asked them to do something extremely inconvenient.", + "upgrade": "Use when you are moving to a newer version (most likely in the context of a minor version). For example, 'Update to the latest version of Flex', 'Auto updates for Flex'.", "upload": "Use as a call to action when a user needs to copy data of the same format from a computer system into a Twilio product", "utilize": "Avoid. Use 'use' instead.", "us": "Using 'us' when referring to Twilio is okay for in-product content. Avoid in technical documentation.", From f95778a7c97a83258e58fbddc865b4ad8d1e82ec Mon Sep 17 00:00:00 2001 From: Megan Date: Fri, 21 Feb 2025 11:24:38 -0500 Subject: [PATCH 3/5] Update packages/paste-website/src/data/word-list.json Co-authored-by: Aren Goetcherian <98958520+aren-twilio@users.noreply.github.com> --- packages/paste-website/src/data/word-list.json | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/packages/paste-website/src/data/word-list.json b/packages/paste-website/src/data/word-list.json index 80ea796095..c60e8edc2e 100644 --- a/packages/paste-website/src/data/word-list.json +++ b/packages/paste-website/src/data/word-list.json @@ -75,7 +75,8 @@ "success/successfully": "Avoid because it is almost always redundant. For example, instead of saying 'Your account was sucessfully created.' we can say 'Your account was created.'", "team member": "Don't use 'teammate' or 'team mate'", "thank you": "Don't use when users completed something they'd do otherwise. Only use when we've asked them to do something extremely inconvenient.", - "upgrade": "Use when you are moving to a newer version (most likely in the context of a minor version). For example, 'Update to the latest version of Flex', 'Auto updates for Flex'.", + "update": "Use when you are moving to a newer version (most likely in the context of a minor version). For example, 'Update to the latest version of Flex', 'Auto updates for Flex'.", + "upgrade": "Reserve for bigger updates that will involve a lot of work. Use the term appropriate to the amount of work involved. Consider this spectrum: [Very little work, one click] Update > Upgrade > Migrate [A lot of work, several steps]" "upload": "Use as a call to action when a user needs to copy data of the same format from a computer system into a Twilio product", "utilize": "Avoid. Use 'use' instead.", "us": "Using 'us' when referring to Twilio is okay for in-product content. Avoid in technical documentation.", From d5f9d664f7bb1f578277616f77be4fe901d20a52 Mon Sep 17 00:00:00 2001 From: Sarah Date: Tue, 25 Feb 2025 12:15:06 -0800 Subject: [PATCH 4/5] fix: add comma --- packages/paste-website/src/data/word-list.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/packages/paste-website/src/data/word-list.json b/packages/paste-website/src/data/word-list.json index 1445ac711f..cf424aec72 100644 --- a/packages/paste-website/src/data/word-list.json +++ b/packages/paste-website/src/data/word-list.json @@ -77,7 +77,7 @@ "team member": "Don't use 'teammate' or 'team mate'", "thank you": "Don't use when users completed something they'd do otherwise. Only use when we've asked them to do something extremely inconvenient.", "update": "Use when you are moving to a newer version (most likely in the context of a minor version). For example, 'Update to the latest version of Flex', 'Auto updates for Flex'.", - "upgrade": "Reserve for bigger updates that will involve a lot of work. Use the term appropriate to the amount of work involved. Consider this spectrum: [Very little work, one click] Update > Upgrade > Migrate [A lot of work, several steps]" + "upgrade": "Reserve for bigger updates that will involve a lot of work. Use the term appropriate to the amount of work involved. Consider this spectrum: [Very little work, one click] Update > Upgrade > Migrate [A lot of work, several steps]", "upload": "Use as a call to action when a user needs to copy data of the same format from a computer system into a Twilio product", "utilize": "Avoid. Use 'use' instead.", "us": "Using 'us' when referring to Twilio is okay for in-product content. Avoid in technical documentation.", From 03e08e3a4f15c9b919ec72beb02c8c282fecf899 Mon Sep 17 00:00:00 2001 From: Sarah Date: Tue, 25 Feb 2025 12:57:06 -0800 Subject: [PATCH 5/5] fix: update expected list length on cypress test --- cypress/integration/word-list/index.spec.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cypress/integration/word-list/index.spec.ts b/cypress/integration/word-list/index.spec.ts index e48466450d..e9b758c079 100644 --- a/cypress/integration/word-list/index.spec.ts +++ b/cypress/integration/word-list/index.spec.ts @@ -15,7 +15,7 @@ describe("Word list with filters", function () { it("should filter the table when a filter string is provided", () => { cy.get('[data-cy="word-list-table"] tbody tr').as("table-rows"); cy.get('[data-cy="word-list-filter-input"]').click().type("ad"); - cy.get("@table-rows").its("length").should("eq", 4); + cy.get("@table-rows").its("length").should("eq", 6); }); it("should show empty state when nothing returned", () => {