diff --git a/docs/html/design/media/help_better.png b/docs/html/design/media/help_better.png new file mode 100644 index 0000000000000..fde5cb297ea6c Binary files /dev/null and b/docs/html/design/media/help_better.png differ diff --git a/docs/html/design/media/help_cling.png b/docs/html/design/media/help_cling.png new file mode 100644 index 0000000000000..c91d18916224f Binary files /dev/null and b/docs/html/design/media/help_cling.png differ diff --git a/docs/html/design/media/help_dont.png b/docs/html/design/media/help_dont.png new file mode 100644 index 0000000000000..a1c9841df7ac4 Binary files /dev/null and b/docs/html/design/media/help_dont.png differ diff --git a/docs/html/design/media/help_evenbetter.png b/docs/html/design/media/help_evenbetter.png new file mode 100644 index 0000000000000..beb88f8ebb4f1 Binary files /dev/null and b/docs/html/design/media/help_evenbetter.png differ diff --git a/docs/html/design/media/help_overflow.png b/docs/html/design/media/help_overflow.png new file mode 100644 index 0000000000000..fb2bc0aa5b252 Binary files /dev/null and b/docs/html/design/media/help_overflow.png differ diff --git a/docs/html/design/media/help_solo_overflow.png b/docs/html/design/media/help_solo_overflow.png new file mode 100644 index 0000000000000..9423edef66c0b Binary files /dev/null and b/docs/html/design/media/help_solo_overflow.png differ diff --git a/docs/html/design/patterns/help.jd b/docs/html/design/patterns/help.jd index fef7a94b0928b..4a92c7bb53f8a 100644 --- a/docs/html/design/patterns/help.jd +++ b/docs/html/design/patterns/help.jd @@ -23,17 +23,17 @@ page.title=Help
    -
  1. High value

    +
  2. High value

    Without it, users wouldn't be able to customize the most frequently-visited Android screen to meet their needs.

  3. -
  4. Available only through a gesture

    +
  5. Available only through a gesture

    Users can't do this through a button or a menu.

  6. -
  7. Atypical for the gesture

    +
  8. Atypical for the gesture

    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.

However, this is an exceptional case. Most functionality doesn't meet all three of these criteria.

- +
The first time each user visits the All Apps screen, a semi-transparent overlay appears to teach an important gesture.
@@ -47,10 +47,10 @@ page.title=Help
- +
- +
Even if your screen has no other action overflow items, "Help" should appear there and not be promoted to the action bar.
@@ -69,35 +69,31 @@ page.title=Help

When someone chooses "Help":

-
-

Don't

- -

Present a dialog asking them to choose between help and other options.

+
+
-
- +
+
+
+ +
-
+
+

Don't

+

Present a dialog asking them to choose between help and other options.

+
+

Better

Immediately launch a web browser with help content. Place other options in a footer.

-
- -
-
- -
-
+

Even Better

Build a help screen in your app and offer other options in the action bar.

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.

-
- -

Principles for Writing On-Screen Help Content