Skip to content

Commit 1edd4ae

Browse files
author
Peter Ng
committed
help image updates
Change-Id: I4357879eb365f5584efb838139132fd9f7a6e1be
1 parent 8874ab0 commit 1edd4ae

File tree

7 files changed

+19
-23
lines changed

7 files changed

+19
-23
lines changed
6.21 KB
Loading
46.1 KB
Loading
13.7 KB
Loading
11 KB
Loading
18.5 KB
Loading
8.6 KB
Loading

docs/html/design/patterns/help.jd

Lines changed: 19 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -23,17 +23,17 @@ page.title=Help
2323
<div class="layout-content-row">
2424
<div class="layout-content-col span-8">
2525
<ol>
26-
<li><h4>High value</h4>
26+
<li><strong>High value</strong>
2727
<p>Without it, users wouldn't be able to customize the most frequently-visited Android screen to meet their needs.</p></li>
28-
<li><h4>Available only through a gesture</h4>
28+
<li><strong>Available only through a gesture</strong>
2929
<p>Users can't do this through a button or a menu.</p></li>
30-
<li><h4>Atypical for the gesture</h4>
30+
<li><strong>Atypical for the gesture</strong>
3131
<p>Many high value functions invoked through a gesture - like scrolling, swiping tabs, and turning pages - are common and yield expected results. Users will be able to discover them in your app, and unsolicited help is unnecessary. But here, the gesture does something unexpected: press and hold doesn't just select an app, it also immediately navigates to the Home Screen and creates a shortcut to the app that can then be dragged around.</p></li>
3232
</ol>
3333
<p>However, this is an exceptional case. Most functionality doesn't meet all three of these criteria.</p>
3434
</div>
3535
<div class="layout-content-col span-5">
36-
<img src="{@docRoot}design/media/swipe_views.png">
36+
<img src="{@docRoot}design/media/help_cling.png">
3737
<div class="figure-caption">
3838
The first time each user visits the All Apps screen, a semi-transparent overlay appears to teach an important gesture.
3939
</div>
@@ -47,10 +47,10 @@ page.title=Help
4747

4848
<div class="layout-content-row">
4949
<div class="layout-content-col span-7">
50-
<img src="{@docRoot}design/media/swipe_views2.png">
50+
<img src="{@docRoot}design/media/help_overflow.png">
5151
</div>
5252
<div class="layout-content-col span-6">
53-
<img src="{@docRoot}design/media/swipe_views2.png">
53+
<img src="{@docRoot}design/media/help_solo_overflow.png">
5454
<div class="figure-caption">
5555
Even if your screen has no other action overflow items, "Help" should appear there and not be promoted to the action bar.
5656
</div>
@@ -69,35 +69,31 @@ page.title=Help
6969
<p>When someone chooses "Help":</p>
7070

7171
<div class="layout-content-row">
72-
<div class="layout-content-col span-7">
73-
<h4 class="do-dont-label bad">Don't</h4>
74-
75-
<p>Present a dialog asking them to choose between help and other options.</p>
72+
<div class="layout-content-col span-4">
73+
<img src="{@docRoot}design/media/help_dont.png">
7674
</div>
77-
<div class="layout-content-col span-6">
78-
<img src="{@docRoot}design/media/swipe_views2.png">
75+
<div class="layout-content-col span-4">
76+
<img src="{@docRoot}design/media/help_better.png">
7977
</div>
78+
<div class="layout-content-col span-5">
79+
<img src="{@docRoot}design/media/help_evenbetter.png">
80+
</div>
8081
</div>
8182

8283
<div class="layout-content-row">
83-
<div class="layout-content-col span-7">
84+
<div class="layout-content-col span-4">
85+
<h4 class="do-dont-label bad">Don't</h4>
86+
<p>Present a dialog asking them to choose between help and other options.</p>
87+
</div>
88+
<div class="layout-content-col span-4">
8489
<h4 class="do-dont-label good">Better</h4>
8590
<p>Immediately launch a web browser with help content. Place other options in a footer.</p>
8691
</div>
87-
<div class="layout-content-col span-6">
88-
<img src="{@docRoot}design/media/swipe_views2.png">
89-
</div>
90-
</div>
91-
92-
<div class="layout-content-row">
93-
<div class="layout-content-col span-7">
92+
<div class="layout-content-col span-5">
9493
<h4 class="do-dont-label good">Even Better</h4>
9594
<p>Build a help screen in your app and offer other options in the action bar.</p>
9695
<p>This requires more development work than launching a web browser, but it's a nicer experience for users because they don't leave your app to get the help they need and doesn't require a network connection.</p>
9796
</div>
98-
<div class="layout-content-col span-6">
99-
<img src="{@docRoot}design/media/swipe_views2.png">
100-
</div>
10197
</div>
10298

10399
<h2>Principles for Writing On-Screen Help Content</h2>

0 commit comments

Comments
 (0)