From 3155825c256b150cfa635ad27ac7a2bab76371b0 Mon Sep 17 00:00:00 2001 From: Dirk Dougherty Date: Sat, 8 Feb 2014 20:29:06 -0800 Subject: Doc change: minor edits to support easier extraction of document summaries. Change-Id: I1a15a1d233464d6c8d35a741c54932412dea28ee --- docs/html/design/building-blocks/buttons.jd | 2 +- docs/html/design/building-blocks/dialogs.jd | 2 +- docs/html/design/building-blocks/grid-lists.jd | 2 +- docs/html/design/building-blocks/index.jd | 3 ++- docs/html/design/building-blocks/lists.jd | 2 +- docs/html/design/building-blocks/pickers.jd | 2 +- docs/html/design/building-blocks/spinners.jd | 2 +- docs/html/design/building-blocks/switches.jd | 2 +- docs/html/design/building-blocks/tabs.jd | 2 +- docs/html/design/building-blocks/text-fields.jd | 2 +- docs/html/design/get-started/creative-vision.jd | 7 ++++++- docs/html/design/index.jd | 3 ++- docs/html/design/patterns/accessibility.jd | 1 + docs/html/design/patterns/actionbar.jd | 1 + docs/html/design/patterns/compatibility.jd | 1 + docs/html/design/patterns/help.jd | 2 +- docs/html/design/patterns/index.jd | 3 ++- docs/html/design/patterns/multi-pane-layouts.jd | 10 ++++++---- docs/html/design/patterns/navigation.jd | 2 +- docs/html/design/patterns/notifications.jd | 2 +- docs/html/design/patterns/selection.jd | 6 +++--- docs/html/design/patterns/settings.jd | 2 +- docs/html/design/patterns/swipe-views.jd | 2 +- docs/html/design/patterns/widgets.jd | 2 +- docs/html/design/style/iconography.jd | 4 +++- docs/html/design/style/index.jd | 3 ++- docs/html/distribute/googleplay/spotlight/index.jd | 5 ++++- docs/html/guide/topics/manifest/action-element.jd | 2 +- docs/html/guide/topics/manifest/activity-alias-element.jd | 2 +- docs/html/guide/topics/manifest/activity-element.jd | 2 +- docs/html/guide/topics/manifest/application-element.jd | 2 +- docs/html/guide/topics/manifest/category-element.jd | 2 +- docs/html/guide/topics/manifest/compatible-screens-element.jd | 2 +- docs/html/guide/topics/manifest/data-element.jd | 2 +- .../html/guide/topics/manifest/grant-uri-permission-element.jd | 2 +- docs/html/guide/topics/manifest/instrumentation-element.jd | 2 +- docs/html/guide/topics/manifest/intent-filter-element.jd | 2 +- docs/html/guide/topics/manifest/manifest-element.jd | 2 +- docs/html/guide/topics/manifest/manifest-intro.jd | 10 +++++----- docs/html/guide/topics/manifest/meta-data-element.jd | 2 +- docs/html/guide/topics/manifest/path-permission-element.jd | 2 +- docs/html/guide/topics/manifest/permission-element.jd | 2 +- docs/html/guide/topics/manifest/permission-group-element.jd | 2 +- docs/html/guide/topics/manifest/permission-tree-element.jd | 2 +- docs/html/guide/topics/manifest/provider-element.jd | 2 +- docs/html/guide/topics/manifest/receiver-element.jd | 2 +- docs/html/guide/topics/manifest/service-element.jd | 2 +- docs/html/guide/topics/manifest/supports-gl-texture-element.jd | 2 +- docs/html/guide/topics/manifest/supports-screens-element.jd | 2 +- docs/html/guide/topics/manifest/uses-configuration-element.jd | 2 +- docs/html/guide/topics/manifest/uses-feature-element.jd | 2 +- docs/html/guide/topics/manifest/uses-library-element.jd | 2 +- docs/html/guide/topics/manifest/uses-permission-element.jd | 2 +- docs/html/guide/topics/manifest/uses-sdk-element.jd | 2 +- docs/html/index.jd | 2 +- 55 files changed, 80 insertions(+), 61 deletions(-) diff --git a/docs/html/design/building-blocks/buttons.jd b/docs/html/design/building-blocks/buttons.jd index 1f7e25d35b0d..8a65b825584f 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 f4bb87e9303c..7cd032cdc29e 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 1a09ef551082..6c9d2278b783 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 e55477567915..7fb0e553be37 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 5514824b056b..0bbd08bb5004 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 6dd72ba06c22..9473d1106429 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 c00b639b39fb..cdc933b6d609 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 74cab5ae2101..dff6c73d5841 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 5a5da5d8ad97..2186b181bc22 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 383531b1adad..3840ca2808e2 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 c57b185c701b..1ce305a5a64d 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 8f73d9ce0e85..9ba32dd5236b 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 532900ecd80c..aaa6f163ca2a 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 b6e3a16563d2..a1adbd33b4a6 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 5ca6d8b9e792..dfc52c0270fb 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 ad5742d78757..e47bc5a71bad 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 4416de1daa5b..e091a29ca5e8 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 06c81897a6b5..6071ef3ccd9d 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 6f2215a28b1d..3e60f66fd8f8 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 80f1b0e20112..41f919027106 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 973ffde9152d..d0ad8372fbda 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 fa3e538c2c5c..7e0485f37a5c 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: