diff --git a/docs/html/design/building-blocks/buttons.jd b/docs/html/design/building-blocks/buttons.jd index 1f7e25d35b0dd..8a65b825584f8 100644 --- a/docs/html/design/building-blocks/buttons.jd +++ b/docs/html/design/building-blocks/buttons.jd @@ -9,7 +9,7 @@ page.tags="button","input" -

A button consists of text and/or an image that clearly communicates what action +

A button consists of text and/or an image that clearly communicates what action will occur when the user touches it. A button can have an image, text, or both.

diff --git a/docs/html/design/building-blocks/dialogs.jd b/docs/html/design/building-blocks/dialogs.jd index f4bb87e9303c4..7cd032cdc29e3 100644 --- a/docs/html/design/building-blocks/dialogs.jd +++ b/docs/html/design/building-blocks/dialogs.jd @@ -9,7 +9,7 @@ page.tags="dialog","alert","popup","toast" -

Dialogs prompt the user for decisions or additional information required by the app to continue a +

Dialogs prompt the user for decisions or additional information required by the app to continue a task. Such requests can range from simple Cancel/OK decisions to more complex layouts asking the user to adjust settings or enter text.

diff --git a/docs/html/design/building-blocks/grid-lists.jd b/docs/html/design/building-blocks/grid-lists.jd index 1a09ef551082a..6c9d2278b783c 100644 --- a/docs/html/design/building-blocks/grid-lists.jd +++ b/docs/html/design/building-blocks/grid-lists.jd @@ -11,7 +11,7 @@ page.tags="gridview","layout","listview" -

Grid lists are an alternative to standard list views. They are best suited for showing data sets +

Grid lists are an alternative to standard list views. They are best suited for showing data sets that represent themselves through images. In contrast to simple lists, grid lists may scroll either vertically or horizontally.

diff --git a/docs/html/design/building-blocks/index.jd b/docs/html/design/building-blocks/index.jd index e554775679156..7fb0e553be37b 100644 --- a/docs/html/design/building-blocks/index.jd +++ b/docs/html/design/building-blocks/index.jd @@ -18,7 +18,8 @@ footer.hide=1
- Your inventory of ready-to-use elements for creating outstanding apps. + Your inventory of ready-to-use elements for creating + outstanding apps.

Tabs
diff --git a/docs/html/design/building-blocks/lists.jd b/docs/html/design/building-blocks/lists.jd index 5514824b056b3..0bbd08bb50048 100644 --- a/docs/html/design/building-blocks/lists.jd +++ b/docs/html/design/building-blocks/lists.jd @@ -9,7 +9,7 @@ page.tags="listview","layout"
-

Lists present multiple line items in a vertical arrangement. They can be used for data selection as +

Lists present multiple line items in a vertical arrangement. They can be used for data selection as well as drilldown navigation.

 
diff --git a/docs/html/design/building-blocks/pickers.jd b/docs/html/design/building-blocks/pickers.jd index 6dd72ba06c22c..9473d1106429a 100644 --- a/docs/html/design/building-blocks/pickers.jd +++ b/docs/html/design/building-blocks/pickers.jd @@ -9,7 +9,7 @@ page.tags="datepicker","timepicker" -

Pickers provide a simple way to select a single value from a set. In addition to touching the +

Pickers provide a simple way to select a single value from a set. In addition to touching the up/down arrow buttons, it's possible to set the desired value from the keyboard or via a swipe gesture.

diff --git a/docs/html/design/building-blocks/spinners.jd b/docs/html/design/building-blocks/spinners.jd index c00b639b39fb7..cdc933b6d6094 100644 --- a/docs/html/design/building-blocks/spinners.jd +++ b/docs/html/design/building-blocks/spinners.jd @@ -9,7 +9,7 @@ page.tags="spinner","dropdown" -

Spinners provide a quick way to select one value from a set. In the default state, a spinner shows +

Spinners provide a quick way to select one value from a set. In the default state, a spinner shows its currently selected value. Touching the spinner displays a dropdown menu with all other available values, from which the user can select a new one.

diff --git a/docs/html/design/building-blocks/switches.jd b/docs/html/design/building-blocks/switches.jd index 74cab5ae21012..dff6c73d5841f 100644 --- a/docs/html/design/building-blocks/switches.jd +++ b/docs/html/design/building-blocks/switches.jd @@ -16,7 +16,7 @@ buttons, and on/off switches.

-

Checkboxes allow the user to select multiple options from a set. Avoid using a single checkbox to +

Checkboxes allow the user to select multiple options from a set. Avoid using a single checkbox to turn an option off or on. Instead, use an on/off switch.

diff --git a/docs/html/design/building-blocks/tabs.jd b/docs/html/design/building-blocks/tabs.jd index 5a5da5d8ad970..2186b181bc22b 100644 --- a/docs/html/design/building-blocks/tabs.jd +++ b/docs/html/design/building-blocks/tabs.jd @@ -11,7 +11,7 @@ page.tags="tabs","actionbar","navigation","viewpager" -

Tabs in the action bar make it easy to explore and switch between different views or functional +

Tabs in the action bar make it easy to explore and switch between different views or functional aspects of your app, or to browse categorized data sets.

For details on using gestures to move between tabs, see the Swipe Views pattern.

diff --git a/docs/html/design/building-blocks/text-fields.jd b/docs/html/design/building-blocks/text-fields.jd index 383531b1adadf..3840ca2808e27 100644 --- a/docs/html/design/building-blocks/text-fields.jd +++ b/docs/html/design/building-blocks/text-fields.jd @@ -9,7 +9,7 @@ page.tags="text","edittext","input" -

Text fields allow the user to type text into your app. They can be either single line or multi-line. +

Text fields allow the user to type text into your app. They can be either single line or multi-line. Touching a text field places the cursor and automatically displays the keyboard. In addition to typing, text fields allow for a variety of other activities, such as text selection (cut, copy, paste) and data lookup via auto-completion.

diff --git a/docs/html/design/get-started/creative-vision.jd b/docs/html/design/get-started/creative-vision.jd index c57b185c701b9..1ce305a5a64d0 100644 --- a/docs/html/design/get-started/creative-vision.jd +++ b/docs/html/design/get-started/creative-vision.jd @@ -5,7 +5,12 @@ page.title=Creative Vision
 
-

We focused the design of Android around three overarching goals, which apply to our core apps as well as the system at large. As you design apps to work with Android, consider these goals:

+

+ We focused the design of Android around three overarching goals, which apply + to our core apps as well as the system at large. As you design apps to work + with Android, consider these goals: Enchant me, Simplify my + life, and Make me amazing +

 
diff --git a/docs/html/design/index.jd b/docs/html/design/index.jd index 8f73d9ce0e853..9ba32dd5236b6 100644 --- a/docs/html/design/index.jd +++ b/docs/html/design/index.jd @@ -22,7 +22,8 @@ footer.hide=1
- Welcome to Android Design, your place for learning how to design exceptional Android apps. + Welcome to Android Design, your place for + learning how to design exceptional Android apps.

Want to know what Android 4.4 KitKat has for designers? See New in Android.

Creative Vision diff --git a/docs/html/design/patterns/accessibility.jd b/docs/html/design/patterns/accessibility.jd index 532900ecd80c5..aaa6f163ca2af 100644 --- a/docs/html/design/patterns/accessibility.jd +++ b/docs/html/design/patterns/accessibility.jd @@ -1,5 +1,6 @@ page.title=Accessibility page.tags="accessibility","navigation","input" +page.metaDescription=Design an app that's universally accessible to people with visual impairment, color deficiency, hearing loss, and limited dexterity. @jd:body diff --git a/docs/html/design/patterns/actionbar.jd b/docs/html/design/patterns/actionbar.jd index b6e3a16563d26..a1adbd33b4a63 100644 --- a/docs/html/design/patterns/actionbar.jd +++ b/docs/html/design/patterns/actionbar.jd @@ -1,5 +1,6 @@ page.title=Action Bar page.tags="actionbar","navigation" +page.metaDescription=The Action bar is an essential design element for all apps. Learn about what the action bar can do and how to use it in your apps. @jd:body diff --git a/docs/html/design/patterns/compatibility.jd b/docs/html/design/patterns/compatibility.jd index 5ca6d8b9e7929..dfc52c0270fb2 100644 --- a/docs/html/design/patterns/compatibility.jd +++ b/docs/html/design/patterns/compatibility.jd @@ -1,5 +1,6 @@ page.title=Backwards Compatibility page.tags="support" +page.metaDescription=Notes on how Android 4.x adapts UI designed for older hardware and OS versions. @jd:body diff --git a/docs/html/design/patterns/help.jd b/docs/html/design/patterns/help.jd index ad5742d78757f..e47bc5a71bad0 100644 --- a/docs/html/design/patterns/help.jd +++ b/docs/html/design/patterns/help.jd @@ -6,7 +6,7 @@ page.tags="settings","preferences"

Some of your users will run into questions or problems along the way. They'll be looking for answers within your app, and if they don't find them quickly, they may leave and never come back.

-

This page covers design patterns for making help accessible in your app and tips for creating help content for users who are eager for assistance.

+

This page covers design patterns for making help accessible in your app and tips for creating help content for users who are eager for assistance.

Designing Help into Your App

diff --git a/docs/html/design/patterns/index.jd b/docs/html/design/patterns/index.jd index 4416de1daa5ba..e091a29ca5e8e 100644 --- a/docs/html/design/patterns/index.jd +++ b/docs/html/design/patterns/index.jd @@ -18,7 +18,8 @@ footer.hide=1
- Design apps that behave in a consistent, predictable fashion. + Design apps that behave in a consistent, predictable + fashion.

New in Android
diff --git a/docs/html/design/patterns/multi-pane-layouts.jd b/docs/html/design/patterns/multi-pane-layouts.jd index 06c81897a6b55..6071ef3ccd9db 100644 --- a/docs/html/design/patterns/multi-pane-layouts.jd +++ b/docs/html/design/patterns/multi-pane-layouts.jd @@ -1,8 +1,8 @@ page.title=Multi-pane Layouts page.tags="tablet","navigation","layout","fragment" +page.metaDescription=Android devices come in many different screen sizes and types. Multi-pane layouts help you provide a balanced and aesthetically pleasing layout across the range of Android devices. @jd:body -

Developer Docs

@@ -10,9 +10,11 @@ page.tags="tablet","navigation","layout","fragment"
-

When writing an app for Android, keep in mind that Android devices come in many different screen -sizes and types. Make sure that your app consistently provides a balanced and aesthetically pleasing -layout by adjusting its content to varying screen sizes and orientations.

+

When writing an app for Android, keep in mind that Android devices +come in many different screen sizes and types. Make sure that your app consistently provides a +balanced and aesthetically pleasing layout by adjusting its content to varying screen sizes and +orientations.

+

Panels are a great way for your app to achieve this. They allow you to combine multiple views into one compound view when a lot of horizontal screen real estate is available and by splitting them up when less space is available.

diff --git a/docs/html/design/patterns/navigation.jd b/docs/html/design/patterns/navigation.jd index 6f2215a28b1d0..3e60f66fd8f87 100644 --- a/docs/html/design/patterns/navigation.jd +++ b/docs/html/design/patterns/navigation.jd @@ -9,7 +9,7 @@ page.tags="navigation","activity","task","up navigation","back navigation"
-

Consistent navigation is an essential component of the overall user experience. Few things frustrate +

Consistent navigation is an essential component of the overall user experience. Few things frustrate users more than basic navigation that behaves in inconsistent and unexpected ways. Android 3.0 introduced significant changes to the global navigation behavior. Thoughtfully following the guidelines for Back and Up will make your app's navigation predictable and reliable for your users.

diff --git a/docs/html/design/patterns/notifications.jd b/docs/html/design/patterns/notifications.jd index 80f1b0e201128..41f9190271067 100644 --- a/docs/html/design/patterns/notifications.jd +++ b/docs/html/design/patterns/notifications.jd @@ -8,7 +8,7 @@ page.title=Notifications
-

The notification system allows your app to keep the user informed about events, such as new chat messages or a calendar event. Think of notifications as a news channel that alerts the user to important events as they happen or a log that chronicles events while the user is not paying attention.

+

The notification system allows your app to keep the user informed about events, such as new chat messages or a calendar event. Think of notifications as a news channel that alerts the user to important events as they happen or a log that chronicles events while the user is not paying attention.

New in Jelly Bean

In Jelly Bean, notifications received their most important structural and functional update since the beginning of Android.

diff --git a/docs/html/design/patterns/selection.jd b/docs/html/design/patterns/selection.jd index 973ffde9152d1..d0ad8372fbda8 100644 --- a/docs/html/design/patterns/selection.jd +++ b/docs/html/design/patterns/selection.jd @@ -35,9 +35,9 @@ the contextual action bar (CAB).

-

Using the contextual action bar (CAB)

-

The selection CAB is a temporary action bar that overlays your app's current action bar while data -is selected. It appears after the user long presses on a selectable data item.

+

Using the contextual action bar

+

The contextual action bar (CAB) is a temporary action bar that overlays your app's current action bar while data +is selected. It appears after the user long-presses on a selectable data item.

diff --git a/docs/html/design/patterns/settings.jd b/docs/html/design/patterns/settings.jd index fa3e538c2c5c1..7e0485f37a5cb 100644 --- a/docs/html/design/patterns/settings.jd +++ b/docs/html/design/patterns/settings.jd @@ -9,7 +9,7 @@ page.tags="preferences","sharedpreferences" -

Settings is a place in your app where users indicate their preferences for how your app should +

Settings is a place in your app where users indicate their preferences for how your app should behave. This benefits users because: