Skip to content

Commit

Permalink
Merge pull request #2450 from Teradata/knapsack/lgn94HUmYC
Browse files Browse the repository at this point in the history
Cards by Felicia
  • Loading branch information
knapsack-cloud[bot] authored Feb 21, 2025
2 parents 61c38f5 + bd97ab4 commit cd5f5da
Show file tree
Hide file tree
Showing 8 changed files with 286 additions and 38 deletions.
22 changes: 22 additions & 0 deletions apps/knapsack/data/blocks/block.IerCs-n0xz.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
{
"id": "IerCs-n0xz",
"data": {
"items": [
{
"fileId": "KvXVAmYdCVAS7hzkOa73Em",
"nodeId": "15962:22789"
},
{
"fileId": "KvXVAmYdCVAS7hzkOa73Em",
"nodeId": "15913:13185"
}
],
"columns": "2",
"imageStyles": {
"fit": "fill",
"size": "auto",
"seamless": true
}
},
"blockType": "design-src-tiles"
}
72 changes: 62 additions & 10 deletions apps/knapsack/data/blocks/block.YQ5OWE4Ajp.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
"type": "paragraph",
"content": [
{
"text": "Heading:",
"text": "Heading",
"type": "text",
"marks": [
{
Expand All @@ -35,7 +35,7 @@
"type": "paragraph",
"content": [
{
"text": "Use sentence style with no ending punctuation.",
"text": "Use imperative verbs and sentence style.",
"type": "text"
}
]
Expand All @@ -44,7 +44,7 @@
"type": "paragraph",
"content": [
{
"text": "Message:",
"text": "Message",
"type": "text",
"marks": [
{
Expand All @@ -58,7 +58,33 @@
"type": "paragraph",
"content": [
{
"text": "Use imperative verbs when speaking to the the user about the task at hand. Don't use permissive language such as \"you can.\"",
"text": "When writing about benefits of completing the task, use the future sense to create a human-like tone, for example, ",
"type": "text"
},
{
"text": "you'll",
"type": "text",
"marks": [
{
"type": "italic"
}
]
},
{
"text": " or ",
"type": "text"
},
{
"text": "they'll",
"type": "text",
"marks": [
{
"type": "italic"
}
]
},
{
"text": ".",
"type": "text"
}
]
Expand All @@ -67,7 +93,20 @@
"type": "paragraph",
"content": [
{
"text": "Use future sense to create a human-like tone when speaking about benefits of the task completion.",
"text": "If the task completion will enable functionalities for other people, be clear about who's doing what by using phrases like ",
"type": "text"
},
{
"text": "they'll",
"type": "text",
"marks": [
{
"type": "italic"
}
]
},
{
"text": "",
"type": "text"
}
]
Expand All @@ -76,7 +115,7 @@
"type": "paragraph",
"content": [
{
"text": "Call to action:",
"text": "Call to action",
"type": "text",
"marks": [
{
Expand Down Expand Up @@ -108,7 +147,7 @@
"type": "paragraph",
"content": [
{
"text": "Heading:",
"text": "Heading",
"type": "text",
"marks": [
{
Expand Down Expand Up @@ -140,7 +179,7 @@
"type": "paragraph",
"content": [
{
"text": "Message:",
"text": "Message",
"type": "text",
"marks": [
{
Expand All @@ -163,7 +202,20 @@
"type": "paragraph",
"content": [
{
"text": "Don't use present sense when talking about benefits of the task completion. We strive to be human and motivating in onboarding.  ",
"text": "Don't use the present sense when writing about benefits of completing the task. The future tense, for example, ",
"type": "text"
},
{
"text": "They'll manage users...,",
"type": "text",
"marks": [
{
"type": "italic"
}
]
},
{
"text": " is a better choice, because onboarding requires a conversational tone.",
"type": "text"
}
]
Expand All @@ -172,7 +224,7 @@
"type": "paragraph",
"content": [
{
"text": "Call to action:",
"text": "Call to action",
"type": "text",
"marks": [
{
Expand Down
112 changes: 112 additions & 0 deletions apps/knapsack/data/blocks/block.b6JcQi3ROy.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,112 @@
{
"id": "b6JcQi3ROy",
"data": {
"guidelines": [
{
"id": "qMQnsmWRh4",
"type": "do",
"content": {
"type": "doc",
"content": [
{
"type": "paragraph",
"content": [
{
"text": "Plan for 30% text expansion to ensure there's room for readable and visually balanced content in the localized versions. With this in mind, follow these guidelines:",
"type": "text"
}
]
},
{
"type": "paragraph",
"content": [
{
"text": " ",
"type": "text"
}
]
},
{
"type": "bulletList",
"content": [
{
"type": "listItem",
"content": [
{
"type": "paragraph",
"content": [
{
"text": "Optimize for the breakpoint width at 1280px because most Teradata users are on large screens.",
"type": "text"
}
]
}
]
},
{
"type": "listItem",
"content": [
{
"type": "paragraph",
"content": [
{
"text": "On a standard 3-card layout, up to 2 lines in the English message is recommended.",
"type": "text"
}
]
}
]
},
{
"type": "listItem",
"content": [
{
"type": "paragraph",
"content": [
{
"text": "On a 2-card layout, up to 1 line in the English message is recommended. ",
"type": "text"
}
]
}
]
}
]
}
]
}
},
{
"id": "bAyEDWVjr",
"type": "dont",
"content": {
"type": "doc",
"content": [
{
"type": "paragraph",
"content": [
{
"text": "Don't truncate any text.",
"type": "text"
}
]
},
{
"type": "paragraph",
"content": [
{
"text": "Cards contain contextually rich information that users need to read in full to make decisions or take action. We use responsive designs so a card grows in height instead of truncating text when the user reduces their screen size. ",
"type": "text"
}
]
}
]
}
}
],
"tileStyles": {
"imageSize": "none"
}
},
"blockType": "guidelines"
}
12 changes: 0 additions & 12 deletions apps/knapsack/data/blocks/block.dBb3191J2T.json
Original file line number Diff line number Diff line change
Expand Up @@ -17,18 +17,6 @@
}
]
},
{
"type": "paragraph",
"attrs": {
"textAlign": "left"
},
"content": [
{
"text": "Onboarding cards are primarily meant for introducing workflows. They allow people to \"learn by doing.\" Upon selecting a call-to-action button, the user is taken to a UI where they complete the task. Linking to documentation is recommended only if data shows the target audience expects to see documentation highlighted during their first-time experience. ",
"type": "text"
}
]
},
{
"type": "paragraph",
"attrs": {
Expand Down
81 changes: 81 additions & 0 deletions apps/knapsack/data/blocks/block.ng6Jr8TiJ.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
{
"id": "ng6Jr8TiJ",
"data": {
"guidelines": [
{
"id": "qMQnsmWRh4",
"type": "do",
"content": {
"type": "doc",
"content": [
{
"type": "paragraph",
"content": [
{
"text": "Link to UIs where people can complete a task. ",
"type": "text"
}
]
},
{
"type": "paragraph",
"content": [
{
"text": "Onboarding cards are primarily meant for introducing workflows. They allow people to learn by doing. ",
"type": "text"
}
]
}
]
}
},
{
"id": "bAyEDWVjr",
"type": "dont",
"content": {
"type": "doc",
"content": [
{
"type": "paragraph",
"content": [
{
"text": "Don't link to documentation.  ",
"type": "text"
}
]
},
{
"type": "paragraph",
"content": [
{
"text": "Use cards to link to UIs where people can complete a task, ",
"type": "text"
},
{
"text": "not read about",
"type": "text",
"marks": [
{
"type": "italic"
}
]
},
{
"text": " how to complete a task.",
"type": "text"
}
]
},
{
"type": "paragraph"
}
]
}
}
],
"tileStyles": {
"imageSize": "none"
}
},
"blockType": "guidelines"
}
Loading

0 comments on commit cd5f5da

Please sign in to comment.