diff --git a/images/ui/empty_state/empty_state_structure.png b/images/ui/empty_state/empty_state_structure.png index ab03829e8..62b8df8cf 100644 Binary files a/images/ui/empty_state/empty_state_structure.png and b/images/ui/empty_state/empty_state_structure.png differ diff --git a/images/ui/empty_state/empty_state_structure_dark.png b/images/ui/empty_state/empty_state_structure_dark.png index aa6f9eec3..096dc62da 100644 Binary files a/images/ui/empty_state/empty_state_structure_dark.png and b/images/ui/empty_state/empty_state_structure_dark.png differ diff --git a/topics/ui/principles/context_help.md b/topics/ui/principles/context_help.md index 50bcbd59c..8fcc4fe5b 100644 --- a/topics/ui/principles/context_help.md +++ b/topics/ui/principles/context_help.md @@ -9,29 +9,30 @@ Use context help to briefly explain how a functionality works if it is not clear Context help can be shown as an [inline help text](inline_help_text.md), in a [help tooltip](tooltip.md), and in an [empty state](empty_state.md). ## Inline help text +Use an [inline help text](inline_help_text.md) in settings dialogs that are not constrained by space and are not frequently used. Since settings are rarely changed, users may forget their purpose, so displaying the information immediately makes sense. Context help in an inline text -Use an [inline help text](inline_help_text.md) in settings dialogs that are not constrained by space and are not frequently used. Since settings are rarely changed, users may forget their purpose, so displaying the information immediately makes sense. - ## Tooltip -Context help in a tooltip - Use a [tooltip](tooltip.md): - If the space is not enough for showing the inline help text. - In frequently used dialogs, tool windows, or popups. The more often a person uses an interface, the more likely they are to remember what each option does. - For icons or other controls that do not have a label. -## Empty state +Context help in a tooltip -Empty state of a tool window + +## Empty state Fill in [empty states](empty_state.md) of tool windows, tables, trees, and other containers with: - a reason why the data is missing - an action that can fix it - a link to a corresponding article in the web help. +Empty state of a tool window + + ## When to use Below you will find rules for [tooltips](tooltip.md) and [inline texts](inline_help_text.md). @@ -96,6 +97,7 @@ Below you will find rules for [tooltips](tooltip.md) and [inline texts](inline_h ## When not to use +### Do not explain UI Do not use context help to explain how the user interface works. If you need to explain that, consider redesigning the UI. @@ -111,6 +113,7 @@ Do not use context help to explain how the user interface works. If you need to
+### Do not explain common actions Do not explain common actions and entities. Show a regular tooltip with an action name and shortcut in this case. @@ -125,6 +128,7 @@ Do not explain common actions and entities. Show a regular tooltip with an actio
+### Do not clutter UI with context help Do not explain each option. Too many help icons or too much inline text make a dialog cluttered and harder to navigate visually. If all options need to be explained, consider rewriting the labels to make them clearer. @@ -140,6 +144,7 @@ If all options need to be explained, consider rewriting the labels to make them + ## How to use See [Inline help text](inline_help_text.md), [Tooltip](tooltip.md), and [](empty_state.md).