You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
### WHY are these changes introduced?
The design pattern page currently includes a section describing the
differences between compositions and patterns. While this information is
valuable to us a team, we are still defining and testing these concepts.
Publishing them on the site at this stage seems to have introduced some
confusion for readers.
### WHAT is this pull request doing?
Removes section on compositions vs patterns until we develop stronger
opinions and feel comfortable publishing them publicly.
Also reorganizes the order of the principles, placing "Contextual" last,
and closest to the related image.
Copy file name to clipboardExpand all lines: polaris.shopify.com/content/patterns/design-patterns.md
+5-32Lines changed: 5 additions & 32 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,19 +15,15 @@ A design pattern is a repeatable solution to a common UX problem in a specific m
15
15
16
16
---
17
17
18
-
### Join the conversation!
18
+
### Join the conversation
19
19
20
20
Do you have ideas or feedback on how we can make these guidelines more empowering and useful? Please share your thoughts in the [GitHub discussion](https://github.com/Shopify/polaris/discussions/6046).
21
21
22
22
---
23
23
24
24
## Principles
25
25
26
-
For patterns to be successful, they need to be contextual, consistent, and unified.
27
-
28
-
### Contextual
29
-
30
-
A pattern is always paired with the problem it solves and the situation it appears in. A solution applied in a context it wasn’t designed for is not a pattern.
26
+
For patterns to be successful, they need to be consistent, unified, and contextual.
31
27
32
28
### Consistent
33
29
@@ -37,31 +33,8 @@ Patterns are always used in the same way for the same reasons. Merchants need to
37
33
38
34
Patterns are always informed by and designed together with similar patterns. For example, patterns with similar purpose should complement each other, and patterns with similar functionality should share appearance and behavior.
39
35
40
-

41
-
42
-
Patterns come with a solution, problem, and situation that belong together. Solutions taken out of this context are no longer a pattern.
43
-
44
-
## Patterns vs. compositions
45
-
46
-
Patterns are for merchants and compositions are for builders.
47
-
48
-
### Pattern purpose
49
-
50
-
- Design the best possible merchant experience
51
-
- Simplify learning the UI
52
-
- Improve recognizability and ease of use
53
-
- Improve merchants’ admin proficiency
54
-
55
-
### Composition purpose
56
-
57
-
- Share as much code as possible
58
-
- Speed up the build process
59
-
- Improve maintainability and reusability
60
-
- Ensure build consistency
36
+
### Contextual
61
37
62
-
### How to distinguish
38
+
A pattern is always paired with the problem it solves and the situation it appears in. A solution applied in a context it wasn’t designed for is not a pattern.
63
39
64
-
- Patterns solve usability problems that relate to the usage of admin, while compositions solve build problems that relate to the build process
0 commit comments