From b684e15dbaaaf5658e2c0c1a75f51319cdbe9fb3 Mon Sep 17 00:00:00 2001
From: Marionne Patel <95588923+marionnegp@users.noreply.github.com>
Date: Thu, 14 Nov 2024 01:21:56 -0500
Subject: [PATCH 1/3] docs(tile): update best practices (#2033)
---
elements/rh-tile/docs/20-guidelines.md | 167 +++++++++++++-----
.../best-practices-link-tile-actions-1.png | Bin 27210 -> 0 bytes
.../best-practices-link-tile-actions-2.png | Bin 3782 -> 0 bytes
.../best-practices-tile-footer-content.png | Bin 24274 -> 0 bytes
.../docs/best-practices-tile-groups-1.png | Bin 51697 -> 0 bytes
.../docs/best-practices-tile-groups-2.png | Bin 76143 -> 0 bytes
.../docs/best-practices-tile-groups-3.png | Bin 54379 -> 0 bytes
.../docs/tile-best-practices-actions-1-do.svg | 19 ++
.../tile-best-practices-actions-1-dont.svg | 23 +++
.../docs/tile-best-practices-actions-2-do.svg | 14 ++
.../tile-best-practices-actions-2-dont.svg | 13 ++
.../tile-best-practices-footer-content-do.svg | 17 ++
...ile-best-practices-footer-content-dont.svg | 16 ++
.../tile-best-practices-image-sizes-do.png | Bin 0 -> 40616 bytes
.../tile-best-practices-image-sizes-dont.png | Bin 0 -> 52629 bytes
.../tile-best-practices-tile-content-do.svg | 24 +++
.../tile-best-practices-tile-content-dont.svg | 30 ++++
...e-best-practices-variants-in-groups-do.svg | 24 +++
...best-practices-variants-in-groups-dont.svg | 44 +++++
19 files changed, 348 insertions(+), 43 deletions(-)
delete mode 100644 elements/rh-tile/docs/best-practices-link-tile-actions-1.png
delete mode 100644 elements/rh-tile/docs/best-practices-link-tile-actions-2.png
delete mode 100755 elements/rh-tile/docs/best-practices-tile-footer-content.png
delete mode 100755 elements/rh-tile/docs/best-practices-tile-groups-1.png
delete mode 100755 elements/rh-tile/docs/best-practices-tile-groups-2.png
delete mode 100755 elements/rh-tile/docs/best-practices-tile-groups-3.png
create mode 100644 elements/rh-tile/docs/tile-best-practices-actions-1-do.svg
create mode 100644 elements/rh-tile/docs/tile-best-practices-actions-1-dont.svg
create mode 100644 elements/rh-tile/docs/tile-best-practices-actions-2-do.svg
create mode 100644 elements/rh-tile/docs/tile-best-practices-actions-2-dont.svg
create mode 100644 elements/rh-tile/docs/tile-best-practices-footer-content-do.svg
create mode 100644 elements/rh-tile/docs/tile-best-practices-footer-content-dont.svg
create mode 100644 elements/rh-tile/docs/tile-best-practices-image-sizes-do.png
create mode 100644 elements/rh-tile/docs/tile-best-practices-image-sizes-dont.png
create mode 100644 elements/rh-tile/docs/tile-best-practices-tile-content-do.svg
create mode 100644 elements/rh-tile/docs/tile-best-practices-tile-content-dont.svg
create mode 100644 elements/rh-tile/docs/tile-best-practices-variants-in-groups-do.svg
create mode 100644 elements/rh-tile/docs/tile-best-practices-variants-in-groups-dont.svg
diff --git a/elements/rh-tile/docs/20-guidelines.md b/elements/rh-tile/docs/20-guidelines.md
index d0415973a3..450337dbb5 100644
--- a/elements/rh-tile/docs/20-guidelines.md
+++ b/elements/rh-tile/docs/20-guidelines.md
@@ -157,65 +157,146 @@ The vertical height of a tile will increase as more content is added. The vertic
## Best practices
-### Link tile actions
-
-Do not use a link tile if it needs to link to more than one destination.
-
-
-
-
+### One action per tile
+
+
+
+
+
+
+ Each tile should go to only one destination or have one action.
+
+
+
+
+
+
+ Do not use a tile if you need to include more than one link or action.
+
+
+### Link tile actions
-A link tile should not be used as a button. A link tile is akin to a call to action and should navigate a user somewhere else.
+
+
+
+
+
+ Link tiles should navigate users to another page or section.
+
+
+
+
+
+
+ A link tile should not be used as a button.
+
+
+
+### Tile variants in groups
+
+
+
+
+
+
+ Use the same variants for a tile group.
+
+
+
+
+
+
-
-
-
+ Avoid using different variants or sub-variants in one tile group.
+
+### Tile content
-### Tile groups
+
+
+
+
-Do not use different variants of a tile in one tile group.
+ When grouped, use the same number of content slots to make them easy to scan.
+
-
-
+
+
-
+ height="392">
+
-When grouped, use the same number of content slots to make them easy to scan.
+ Do not use a different number of content slots in grouped tiles.
+
-
-
+
+
-
+ height="320">
+
-If tiles have images, the images should have the same height. This will help the headings of each tile align vertically which also helps users scan more easily.
+ If grouped tiles have images, the images should have the same height. This will keep the headings of each tile aligned, which helps users scan more easily.
+
-
-
+
+
-
+
+ Images for tiles in a group should not be different heights.
+
### Footer content
-The footer of a link tile or selectable tile should not include calls to action, links, or buttons, but it can include non-interactive elements, like tags or badges. Ideally, footer content should be able to fit on one line, but it can wrap to two when necessary.
-
-
-
-
+
+
+
+
+
+ The footer of a tile can include non-interactive elements, like unlinked tags or badges. Ideally, footer content should be able to fit on one line, but it can wrap to two when necessary.
+
+
+
+
+
+
+ Do not use a tile if you need to include more than one link or action.
+
+
\ No newline at end of file
diff --git a/elements/rh-tile/docs/best-practices-link-tile-actions-1.png b/elements/rh-tile/docs/best-practices-link-tile-actions-1.png
deleted file mode 100644
index 64c6698b6dd43495f6564095e0347d8d7cf773dd..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 27210
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