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

Rename "Library" to just "Patterns" #52042

Closed
mtias opened this issue Jun 28, 2023 · 10 comments · Fixed by #52102
Closed

Rename "Library" to just "Patterns" #52042

mtias opened this issue Jun 28, 2023 · 10 comments · Fixed by #52102
Assignees
Labels
Blessed for major release Can be iterated during a WordPress beta period [Feature] Patterns A collection of blocks that can be synced (previously reusable blocks) or unsynced [Feature] Site Editor Related to the overarching Site Editor (formerly "full site editing") [Type] Task Issues or PRs that have been broken down into an individual action to take

Comments

@mtias
Copy link
Member

mtias commented Jun 28, 2023

For 6.3 Beta

As we are taking the opportunity to unify some concepts and streamline how users work with patterns, reusable blocks, and template parts, we ended up using the generic label Library. I think this is suboptimal for a few reasons, so I propose calling it just Patterns.

Rationale

  • Discovery: this is an opportunity to make patterns front and center as we are introducing the ability to save custom patterns. They should be front and center in the "Design" tab.
  • Clarity: library can be obscure and overlaps with other terminology (like Media Library). We didn't get to add font library management in this round, but it would have made things more confusing (would a user expect to see their font library under "Styles" or an item called "Library"?). Calling it patterns removes that ambiguity.
  • Presence: patterns is a unique name that has been established in the WP branding parlance for a bit and deserves more clear placement.
@mtias mtias added [Type] Task Issues or PRs that have been broken down into an individual action to take [Feature] Patterns A collection of blocks that can be synced (previously reusable blocks) or unsynced [Feature] Site Editor Related to the overarching Site Editor (formerly "full site editing") labels Jun 28, 2023
@carolinan
Copy link
Contributor

carolinan commented Jun 28, 2023

I think this is too early and confusing at this time, because template parts are not renamed to patterns in this version.
It is confusing enough that the UI includes "pattern" in the heading and description, when it is not a pattern.

For someone who sees the updated navigation sidebar for the first time, it will be confusing because the previous template part menu item is missing, it is not that intuitive to look for them under "Patterns".

A declaration of intent for a future version, would help prepare users.

@mtias
Copy link
Member Author

mtias commented Jun 28, 2023

I hear you, but I do think it's more intuitive to find them under a Patterns label (that's how you discover headers and footers in the directory, for example) than under a generic term Library. Block template parts have always been design patterns, we just discriminated based on data organization, permissions, and theme building semantics.

If this proves difficult to do in one go based on feedback we hear during beta we can pull out template parts out of it into the root level. But in both cases, Library is unnecessary.

@t-hamano
Copy link
Contributor

If I understand correctly, the words mentioned here mean the following:

  • Patterns: means the concept of design patterns. Block patterns, template parts, etc. are included in this concept.
  • Pattern: means "block pattern" which is a set of multiple blocks.

In English, the meaning may be identified by whether it is singular or plural. However, languages, especially in Asia, do not identify singular and plural and have the same word.

If the word Library were renamed Patterns, we would be more unable to identify whether it represents a design pattern or a block pattern.

@mtias
Copy link
Member Author

mtias commented Jun 28, 2023

Not making a distinction here between "design patterns" and "block pattern", it should be the same.

@priethor priethor added the Blessed for major release Can be iterated during a WordPress beta period label Jun 28, 2023
@jasmussen
Copy link
Contributor

I quite like "Patterns", and these reasons stand out to me:

  • I'd look for "Fonts" in "Styles" anyway
  • "Patterns" won't confuse me with Media Library

Mostly, as the WordPress pattern library gets integrated, as patterns get upgraded, and as the Patterns block (#48458) comes into being, having a singular section that embodies these feels like a really strong proposition, as the central place where you can manage, review, even edit your patterns in a central and easily findable place. I think this is going to be especially important to have in the site editor, as I could see a future where patterns can be copied over from one theme to the next between theme activations, needing a place to live on in their theme-detached state. "Library" just feels less obvious for those flows.

@annezazu annezazu moved this to 🗣️ In discussion, needs decision in WordPress 6.3.x Editor Tasks Jun 28, 2023
@carolinan
Copy link
Contributor

Placing patterns under a menu item called patterns is not the issue: Placing things that are not patterns under the same menu makes them difficult to discover.

@aaronrobertshaw
Copy link
Contributor

I've made a start on the process of renaming the Library to Patterns (#52102). It might help the discussion if people can see the Patterns section in action.

@aaronrobertshaw
Copy link
Contributor

It looks like we'll be going ahead with the renaming of Library to Patterns in #52102 so it can make the next beta. Any feedback on it in action is very much welcome.

It also seems the sticking point around template parts being under patterns, could be a subjective one, depending on how you feel about template parts really being a special type of pattern. Perhaps that concern could be lessened by knowing that any discomfort here should be temporary as we work through unifying everything pattern related; parts, reusable blocks, patterns etc.

Thank you for the discussion and concerns shared here 👍

@carolinan
Copy link
Contributor

I would like to see a bigger effort on helping the users transition and use the interface intuitively and efficiently, my perceived "feelings of discomfort" are not what matters.

@aaronrobertshaw
Copy link
Contributor

My apologies if I came across as dismissive in my last comment, my aim was to reassure that our efforts on unifying patterns and resolving this issue are only just beginning.

Your concern is 100% valid and I should have communicated that better.

We have every intention of helping guide users in their transition. The Patterns feature is evolving rapidly and there are already some PRs being created adding guidance for the block editor side of things. That PR is only an initial step, we have plans to add some guidance around Patterns in the site editor early next week.

If you have the bandwidth, it would be great if you could review the coming enhancements and make sure they measure up.

Thank you again for the clarification and feedback 🙇

@github-project-automation github-project-automation bot moved this from 🗣️ In discussion, needs decision to ✅ Done in WordPress 6.3.x Editor Tasks Jun 30, 2023
@priethor priethor removed the [Status] In Progress Tracking issues with work in progress label Jun 30, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Blessed for major release Can be iterated during a WordPress beta period [Feature] Patterns A collection of blocks that can be synced (previously reusable blocks) or unsynced [Feature] Site Editor Related to the overarching Site Editor (formerly "full site editing") [Type] Task Issues or PRs that have been broken down into an individual action to take
Projects
No open projects
Development

Successfully merging a pull request may close this issue.

6 participants