Skip to content

Commit

Permalink
Merge pull request #2323 from Teradata/docs/adapting-tone
Browse files Browse the repository at this point in the history
docs(knapsack): getting back adapting tone page
  • Loading branch information
adamnel authored Jan 13, 2025
2 parents f214079 + 49f2902 commit c616152
Show file tree
Hide file tree
Showing 29 changed files with 2,194 additions and 0 deletions.
36 changes: 36 additions & 0 deletions apps/knapsack/data/blocks/block.3nK9KuZ4DN.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
{
"id": "3nK9KuZ4DN",
"data": {
"content": {
"type": "doc",
"content": [
{
"type": "paragraph",
"attrs": {
"textAlign": "left"
},
"content": [
{
"text": "The UI makes clear what the user needs to do before they select ",
"type": "text"
},
{
"text": "Add provider",
"type": "text",
"marks": [
{
"type": "bold"
}
]
},
{
"text": "",
"type": "text"
}
]
}
]
}
},
"blockType": "text-editor"
}
54 changes: 54 additions & 0 deletions apps/knapsack/data/blocks/block.5xYWkMJtI.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
{
"id": "5xYWkMJtI",
"data": {
"gridStyles": {
"columns": "2",
"centered": true
},
"guidelines": [
{
"id": "DOFCYTlw5p",
"type": "do",
"content": {
"type": "doc",
"content": [
{
"type": "paragraph",
"content": [
{
"text": "An identity provider stores, secures, and authenticates the digital identities of users.",
"type": "text"
}
]
}
]
}
},
{
"id": "TbKgEi84d9",
"type": "dont",
"content": {
"type": "doc",
"content": [
{
"type": "paragraph",
"content": [
{
"text": "An identity provider stores, secures, and authenticates the digital identities of users, devices, or applications.",
"type": "text"
}
]
}
]
}
}
],
"tileStyles": {
"imageSize": "none",
"imageRounded": true,
"imageOutlined": true,
"headerBeforeImage": false
}
},
"blockType": "guidelines"
}
69 changes: 69 additions & 0 deletions apps/knapsack/data/blocks/block.7TZEfGqFM.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
{
"id": "7TZEfGqFM",
"data": {
"content": {
"type": "doc",
"content": [
{
"type": "heading",
"attrs": {
"level": 1,
"textAlign": "left"
},
"content": [
{
"text": "Tone spectrum",
"type": "text"
}
]
},
{
"type": "paragraph",
"attrs": {
"textAlign": "left"
},
"content": [
{
"text": "The tone spectrum is a mental model for you as you choose the right tone according to your user's situation in their product experience. The sliding gradient represents all possible situations throughout the user journey. We can't describe them all, because so many factors are at play. ",
"type": "text"
}
]
},
{
"type": "paragraph",
"attrs": {
"textAlign": "left"
},
"content": [
{
"text": "We call out 3 example points on the spectrum, and each aligns with a situation and tone guideline. The three points are not absolute. ",
"type": "text"
},
{
"text": "The right tone could come from a combination of them or points in between.",
"type": "text",
"marks": [
{
"type": "bold"
}
]
}
]
},
{
"type": "paragraph",
"attrs": {
"textAlign": "left"
},
"content": [
{
"text": "Use the guidelines to help you apply the right tone to common situations users encounter, and adapt them to other situations along the spectrum. Ultimately, use what you know about the user in the specific situation, and be ready to make a judgement call with the many factors at play. ",
"type": "text"
}
]
}
]
}
},
"blockType": "text-editor"
}
23 changes: 23 additions & 0 deletions apps/knapsack/data/blocks/block.A4rHmg9Khg.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
{
"id": "A4rHmg9Khg",
"data": {
"content": {
"type": "doc",
"content": [
{
"type": "paragraph",
"attrs": {
"textAlign": "left"
},
"content": [
{
"text": "The job to be done that this task supports is setting up single sign-on. Users are relevant, but devices and applications are not.",
"type": "text"
}
]
}
]
}
},
"blockType": "text-editor"
}
89 changes: 89 additions & 0 deletions apps/knapsack/data/blocks/block.Ew3EmXiXyW.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
{
"id": "Ew3EmXiXyW",
"data": {
"gridStyles": {
"columns": "2",
"centered": true
},
"guidelines": [
{
"id": "TbKgEi84d9",
"type": "do",
"content": {
"type": "doc",
"content": [
{
"type": "paragraph",
"content": [
{
"text": "Complete the information, then select ",
"type": "text"
},
{
"text": "Add provider",
"type": "text",
"marks": [
{
"type": "bold"
}
]
},
{
"text": ".",
"type": "text"
}
]
}
]
}
},
{
"id": "DOFCYTlw5p",
"type": "dont",
"content": {
"type": "doc",
"content": [
{
"type": "paragraph",
"content": [
{
"text": "Complete the information, then map the required claims (for OpenID Connect) or attribute values (for SAML).",
"type": "text"
}
]
},
{
"type": "paragraph",
"content": [
{
"text": "Select ",
"type": "text"
},
{
"text": "Add provider",
"type": "text",
"marks": [
{
"type": "bold"
}
]
},
{
"text": ".",
"type": "text"
}
]
}
]
}
}
],
"tileStyles": {
"imageSize": "none",
"imageRounded": true,
"imageOutlined": true,
"headerBeforeImage": false
}
},
"blockType": "guidelines"
}
36 changes: 36 additions & 0 deletions apps/knapsack/data/blocks/block.K4Bfb-xLFz.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
{
"id": "K4Bfb-xLFz",
"data": {
"content": {
"type": "doc",
"content": [
{
"type": "heading",
"attrs": {
"level": 2,
"textAlign": "left"
},
"content": [
{
"text": "Transparent and neutral",
"type": "text"
}
]
},
{
"type": "paragraph",
"attrs": {
"textAlign": "left"
},
"content": [
{
"text": "Situation: While using a product, a user encounters an error.",
"type": "text"
}
]
}
]
}
},
"blockType": "text-editor"
}
35 changes: 35 additions & 0 deletions apps/knapsack/data/blocks/block.KfeIuYKj2w.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
{
"id": "KfeIuYKj2w",
"data": {
"content": {
"type": "doc",
"content": [
{
"type": "paragraph",
"attrs": {
"textAlign": "left"
},
"content": [
{
"text": "We don’t want users to feel they have a lot to read. To help them complete tasks efficiently and feel good about it, write only what they need.",
"type": "text"
}
]
},
{
"type": "paragraph",
"attrs": {
"textAlign": "left"
},
"content": [
{
"text": "Let's look at the example more closely.",
"type": "text"
}
]
}
]
}
},
"blockType": "text-editor"
}
Loading

0 comments on commit c616152

Please sign in to comment.