Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update "detach" language for navigation block and synced patterns flow #54625

Open
annezazu opened this issue Sep 19, 2023 · 6 comments · Fixed by #56829
Open

Update "detach" language for navigation block and synced patterns flow #54625

annezazu opened this issue Sep 19, 2023 · 6 comments · Fixed by #56829
Labels
Needs Copy Review Needs review of user-facing copy (language, phrasing) Needs Design Feedback Needs general design feedback. [Type] Enhancement A suggestion for improvement.

Comments

@annezazu
Copy link
Contributor

Currently for both the Page List block in the Navigation block and Synced Patterns, we use the phrase "detach", which while technically accurate isn't terribly user friendly. This came up as part of the Hallway Hangout on improving accessibility in the Site Editor as it's both not clear to sighted and visually impaired users (not to mention the i18 impact).

Here's a video showing both experiences:

detach.language.mov

Let's throw out some new language options and get some copy help. For starters, I'd love to have these two flows use the same language but it may not make sense to. For example, for the navigation block, it might make more sense to just say "Confirm" rather than "Detach". For patterns, we could go back to the "convert to blocks" language.

@annezazu annezazu added [Type] Enhancement A suggestion for improvement. Needs Design Feedback Needs general design feedback. Needs Copy Review Needs review of user-facing copy (language, phrasing) labels Sep 19, 2023
@annezazu annezazu changed the title Update "detach" language for navigation block and synced patterns Update "detach" language for navigation block and synced patterns flow Sep 19, 2023
@richtabor
Copy link
Member

I'm not sure of a different verb that helps denote the breaking away of the synced set. It's worth noting that Figma uses detach as well. Notion uses "unsync". Know of others?

@annezazu
Copy link
Contributor Author

I'm not aware of others but will start paying attention. ChatGPT offers unhook, unlink, release, untie (none I like). My mind goes to disconnect or separate. I agree though, it's tricky to get right but the current phrasing isn't immediately clear.

@getdave
Copy link
Contributor

getdave commented Dec 6, 2023

This page list is synced with the published pages on your site. Detach the page list to add, delete, or reorder pages yourself.

In the specific example of the Navigation block we could make the wording (shown above) more user friendly and less technical. It should describe what will happen rather than what is happening technically.

How about something like...

The page list displays your site's published pages. If you choose to edit the list, you will be able to independently adjust navigation items, but your navigation will no longer automatically update with changes to your site's pages.

Also cc'ing @alexstine for his opinion as he had specific comments about the wording in the referenced Hallway Hangout.


Question: if we go ahead with changes should the buttons be updated to be more of a "confirmation" (e.g. "Confirm", "Cancel"). Certainly "Detach" is not a good term here.

@richtabor
Copy link
Member

Question: if we go ahead with changes should the buttons be updated to be more of a "confirmation" (e.g. "Confirm", "Cancel"). Certainly "Detach" is not a good term here.

The affirmation action should be relative to what invoked the modal. For example, the "Create pattern" control opens a modal titled "Create pattern" and the action is "Create".

Following this, the action should be "Edit".

CleanShot 2023-12-06 at 09 11 11
CleanShot 2023-12-06 at 09 11 38

@alexstine
Copy link
Contributor

👍 Thanks.

@annezazu
Copy link
Contributor Author

Reopening as synced patterns remains an issue.

@annezazu annezazu reopened this Dec 21, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Needs Copy Review Needs review of user-facing copy (language, phrasing) Needs Design Feedback Needs general design feedback. [Type] Enhancement A suggestion for improvement.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants