diff --git a/docs/html/design/building-blocks/buttons.jd b/docs/html/design/building-blocks/buttons.jd index 2a77e24be793b..3a34601a25d16 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 f9897f44e23d2..53d99b8bf8046 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 cef7514b925b0..d98637cce8c5a 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 54fa442728335..4949d00fb949a 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 860a126fa44dd..fb5e287339bf8 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 f8d92d4aec182..f7d80e7d65ba5 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 b2946897fed19..d4356572dd36b 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 1fa3461be37ee..93818c3907a57 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 4545bfbaf4965..e109d5fddc8f0 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 50c82febc4510..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.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 @@ -86,4 +87,4 @@ page.tags=accessibility,navigation,input
  • Provide alternatives to affordances that time out
  • Use standard framework controls or enable TalkBack for custom controls
  • Try it out yourself
    • - + \ No newline at end of file diff --git a/docs/html/design/patterns/actionbar.jd b/docs/html/design/patterns/actionbar.jd index f0104b53ca4ca..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.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 @@ -277,4 +278,4 @@ actions exceeds the capacity of the main action bar, display them separately in

    Sometimes it is important to display contextual information for your app that's always visible. Examples are the number of unread messages in a messaging inbox view or the Now Playing information in a music player. Carefully plan which important information you would like to display and -structure your action bars accordingly.

    +structure your action bars accordingly.

    \ No newline at end of file diff --git a/docs/html/design/patterns/compatibility.jd b/docs/html/design/patterns/compatibility.jd index 5a1562c833438..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.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 bf708b14eece7..97949e23326ed 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 ff2dd4e0293f5..c20700644037d 100644 --- a/docs/html/design/patterns/multi-pane-layouts.jd +++ b/docs/html/design/patterns/multi-pane-layouts.jd @@ -1,5 +1,6 @@ page.title=Multi-pane Layouts -page.tags=tablet,navigation,layout,fragment +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 @@ -10,9 +11,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 08828e8be336e..3edf6ba506055 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 ee46795b02848..be316778d7379 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 a09193de5dd27..e3a3f05c0b6bc 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: