Skip to content

Commit b10b48f

Browse files
committed
docs: remove gerunds from UI dev guides and resolve linkbacks
Change-Id: Idc8b017aa202dd2dc6240eb348a7a89a6369ff55
1 parent cb18db8 commit b10b48f

File tree

26 files changed

+90
-94
lines changed

26 files changed

+90
-94
lines changed

docs/html/guide/guide_toc.cs

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -101,41 +101,41 @@ localized titles are added in the language order specified below.
101101
</a></div>
102102
<ul>
103103
<li><a href="<?cs var:toroot ?>guide/topics/ui/declaring-layout.html">
104-
<span class="en">Declaring Layout</span>
104+
<span class="en">XML Layouts</span>
105+
</a></li>
106+
<li><a href="<?cs var:toroot ?>guide/topics/ui/ui-events.html">
107+
<span class="en">Input Events</span>
105108
</a></li>
106109
<li><a href="<?cs var:toroot ?>guide/topics/ui/menus.html">
107-
<span class="en">Creating Menus</span>
110+
<span class="en">Menus</span>
108111
</a></li>
109112
<li><a href="<?cs var:toroot ?>guide/topics/ui/actionbar.html">
110-
<span class="en">Using the Action Bar</span>
113+
<span class="en">Action Bar</span>
111114
</a></li>
112115
<li><a href="<?cs var:toroot ?>guide/topics/ui/dialogs.html">
113-
<span class="en">Creating Dialogs</span>
114-
</a></li>
115-
<li><a href="<?cs var:toroot ?>guide/topics/ui/ui-events.html">
116-
<span class="en">Handling UI Events</span>
116+
<span class="en">Dialogs</span>
117117
</a></li>
118118
<li class="toggle-list">
119119
<div><a href="<?cs var:toroot ?>guide/topics/ui/notifiers/index.html">
120-
<span class="en">Notifying the User</span>
120+
<span class="en">Notifications</span>
121121
</a></div>
122122
<ul>
123123
<li><a href="<?cs var:toroot ?>guide/topics/ui/notifiers/toasts.html">
124-
<span class="en">Creating Toast Notifications</span>
124+
<span class="en">Toast Notifications</span>
125125
</a></li>
126126
<li><a href="<?cs var:toroot ?>guide/topics/ui/notifiers/notifications.html">
127-
<span class="en">Creating Status Bar Notifications</span>
127+
<span class="en">Status Bar Notifications</span>
128128
</a></li>
129129
</ul>
130130
</li>
131131
<li><a href="<?cs var:toroot ?>guide/topics/ui/drag-drop.html">
132-
<span class="en">Dragging and Dropping</span>
132+
<span class="en">Drag and Drop</span>
133133
</a></li>
134134
<li><a href="<?cs var:toroot ?>guide/topics/ui/themes.html">
135-
<span class="en">Applying Styles and Themes</span>
135+
<span class="en">Styles and Themes</span>
136136
</a></li>
137137
<li><a href="<?cs var:toroot ?>guide/topics/ui/custom-components.html">
138-
<span class="en">Building Custom Components</span>
138+
<span class="en">Custom Components</span>
139139
</a></li>
140140
<li><a href="<?cs var:toroot ?>guide/topics/ui/binding.html">
141141
<span class="en">Binding to Data with AdapterView</span>

docs/html/guide/practices/design/seamlessness.jd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,7 @@ interface they've come to expect. When designing your UIs, you should try and
171171
avoid rolling your own as much as possible. Instead, use a Theme. You
172172
can override or extend those parts of the theme that you need to, but at least
173173
you're starting from the same UI base as all the other applications. For all
174-
the details, read <a href="{@docRoot}guide/topics/ui/themes.html">Applying Styles and Themes</a>.</p>
174+
the details, read <a href="{@docRoot}guide/topics/ui/themes.html">Styles and Themes</a>.</p>
175175

176176
<h2 id="flexui">Design Your UI to Work with Multiple Screen Resolutions</h2>
177177

docs/html/guide/practices/ui_guidelines/menu_design.jd

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -260,8 +260,8 @@ or device to another.
260260
<img src={@docRoot}images/menu_design/TaskFlowDiagram.png>
261261

262262
<p>
263-
For more technical information on menus, see
264-
<a href="{@docRoot}guide/topics/ui/menus.html">Creating Menus</a>.
263+
For more technical information on menus, see the
264+
<a href="{@docRoot}guide/topics/ui/menus.html">Menus</a> developer guide.
265265
</p>
266266

267267
<h3 id="commands_fixed">Commands Fixed in an Activity Screen</h4>

docs/html/guide/topics/appwidgets/index.jd

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -297,8 +297,7 @@ Guidelines</a>.</p>
297297

298298
<p>Creating the App Widget layout is simple if you're
299299
familiar with <a
300-
href="{@docRoot}guide/topics/ui/declaring-layout.html">Declaring Layout in
301-
XML</a>.
300+
href="{@docRoot}guide/topics/ui/declaring-layout.html">XML Layouts</a>.
302301
However, you must be aware that App Widget layouts are based on {@link
303302
android.widget.RemoteViews},
304303
which do not support every kind of layout or view widget.</p>

docs/html/guide/topics/fundamentals/fragments.jd

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -631,8 +631,9 @@ selects a menu item. If the activity's implementation of the on-item-selected ca
631631
handle the selected item, then the event is passed to the fragment's callback. This is true for
632632
the Options Menu and context menus.</p>
633633

634-
<p>For more information about menus, see <a href="{@docRoot}guide/topics/ui/menus.html">Creating
635-
Menus</a> and <a href="{@docRoot}guide/topics/ui/actionbar.html">Using the Action Bar</a>.</p>
634+
<p>For more information about menus, see the <a
635+
href="{@docRoot}guide/topics/ui/menus.html">Menus</a> and <a
636+
href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> developer guides.</p>
636637

637638

638639

docs/html/guide/topics/graphics/index.jd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -150,7 +150,7 @@ use your Canvas to draw a Bitmap handled by the system.</p>
150150
<p class="note"><strong>Note: </strong> In order to request an invalidate from a thread other than your main
151151
Activity's thread, you must call <code>{@link android.view.View#postInvalidate()}</code>.</p>
152152

153-
<p>Also read <a href="{@docRoot}guide/topics/ui/custom-components.html">Building Custom Components</a>
153+
<p>Also read <a href="{@docRoot}guide/topics/ui/custom-components.html">Custom Components</a>
154154
for a guide to extending a View class, and <a href="2d-graphics.html">2D Graphics: Drawables</a> for
155155
information on using Drawable objects like images from your resources and other primitive shapes.</p>
156156

docs/html/guide/topics/resources/layout-resource.jd

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ parent.link=available-resources.html
77
<div id="qv">
88
<h2>See also</h2>
99
<ol>
10-
<li><a href="{@docRoot}guide/topics/ui/declaring-layout.html">Declaring Layout</a></li>
10+
<li><a href="{@docRoot}guide/topics/ui/declaring-layout.html">XML Layouts</a></li>
1111
</ol>
1212
</div>
1313
</div>
@@ -127,8 +127,9 @@ or {@code "wrap_content"}). See the <a href="#layoutvalues">valid values</a> bel
127127
</dl>
128128
<p>More attributes are supported by the {@link android.view.View}
129129
base class, and many more are supported by each implementation of
130-
{@link android.view.View}. Read <a href="{@docRoot}guide/topics/ui/declaring-layout.html">Declaring
131-
Layout</a> for more information. For a reference of all available attributes,
130+
{@link android.view.View}. Read <a
131+
href="{@docRoot}guide/topics/ui/declaring-layout.html">XML Layouts</a> for more information. For
132+
a reference of all available attributes,
132133
see the corresponding reference documentation (for example, the <a
133134
href="{@docRoot}reference/android/widget/TextView.html#lattrs">TextView XML attributes</a>).</p>
134135
</dd>
@@ -235,7 +236,8 @@ deprecate <code>fill_parent</code>.</td>
235236
<p>You can create your own custom {@link android.view.View} and {@link android.view.ViewGroup}
236237
elements and apply them to your layout the same as a standard layout
237238
element. You can also specify the attributes supported in the XML element. To learn more,
238-
read <a href="{@docRoot}guide/topics/ui/custom-components.html">Building Custom Components</a>.
239+
see the <a href="{@docRoot}guide/topics/ui/custom-components.html">Custom Components</a> developer
240+
guide.
239241
</p>
240242

241243
</dd> <!-- end elements and attributes -->
@@ -273,7 +275,7 @@ public void onCreate(Bundle savedInstanceState) {
273275
<dt>see also:</dt>
274276
<dd>
275277
<ul>
276-
<li><a href="{@docRoot}guide/topics/ui/declaring-layout.html">Declaring Layout</a></li>
278+
<li><a href="{@docRoot}guide/topics/ui/declaring-layout.html">XML Layouts</a></li>
277279
<li>{@link android.view.View}</li>
278280
<li>{@link android.view.ViewGroup}</li>
279281
</ul>

docs/html/guide/topics/resources/localization.jd

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ defaults.</li>
5252
<li><a
5353
href="{@docRoot}resources/tutorials/localization/index.html">Hello, L10N Tutorial</a></li>
5454
<li><a href="{@docRoot}guide/topics/resources/providing-resources.html">Providing Resources</a></li>
55-
<li><a href="{@docRoot}guide/topics/ui/declaring-layout.html">Declaring Layout</a></li>
55+
<li><a href="{@docRoot}guide/topics/ui/declaring-layout.html">XML Layouts</a></li>
5656
<li><a href="{@docRoot}reference/android/app/Activity.html#ActivityLifecycle">Activity Lifecycle</a></li>
5757
</ol>
5858
</div>

docs/html/guide/topics/resources/menu-resource.jd

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,16 @@ parent.link=available-resources.html
77
<div id="qv">
88
<h2>See also</h2>
99
<ol>
10-
<li><a href="{@docRoot}guide/topics/ui/menus.html">Creating Menus</a></li>
10+
<li><a href="{@docRoot}guide/topics/ui/menus.html">Menus</a></li>
1111
</ol>
1212
</div>
1313
</div>
1414

1515
<p>A menu resource defines an application menu (Options Menu, Context Menu, or submenu) that
1616
can be inflated with {@link android.view.MenuInflater}.</p>
1717

18-
<p>For a guide to using menus, see the <a href="{@docRoot}guide/topics/ui/menus.html">Creating
19-
Menus</a> document.</p>
18+
<p>For a guide to using menus, see the <a href="{@docRoot}guide/topics/ui/menus.html">Menus</a>
19+
developer guide.</p>
2020

2121
<dl class="xml">
2222

@@ -132,22 +132,22 @@ Avoid using this unless it's critical that the item always appear in the action
132132
bar. Setting multiple items to always appear as action items can result in them overlapping
133133
with other UI in the action bar.</td></tr>
134134
</table>
135-
<p>See <a href="{@docRoot}guide/topics/ui/actionbar.html">Using the Action Bar</a> for
136-
more information.</p>
135+
<p>See the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> developer
136+
guide for more information.</p>
137137
<p>Introduced in API Level 11.</p>
138138
</dd>
139139

140140
<dt><code>android:actionViewLayout</code></dt>
141141
<dd><em>Layout resource</em>. A layout to use as the action view.
142-
<p>See <a href="{@docRoot}guide/topics/ui/actionbar.html">Using the Action Bar</a> for
143-
more information.</p>
142+
<p>See the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> developer
143+
guide for more information.</p>
144144
<p>Introduced in API Level 11.</p></dd>
145145

146146
<dt><code>android:actionViewClassName</code></dt>
147147
<dd><em>Class name</em>. A fully-qualified class name for the {@link android.view.View}
148148
to use as the action view.
149-
<p>See <a href="{@docRoot}guide/topics/ui/actionbar.html">Using the Action Bar</a> for
150-
more information.</p>
149+
<p>See the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> developer
150+
guide for more information.</p>
151151
<p class="warning"><strong>Warning:</strong> If you obfuscate your code using <a
152152
href="{@docRoot}guide/developing/tools/proguard.html">ProGuard</a> (or a similar tool),
153153
be sure to exclude the class you specify in this attribute from renaming, because it can break the

docs/html/guide/topics/resources/style-resource.jd

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ parent.link=available-resources.html
77
<div id="qv">
88
<h2>See also</h2>
99
<ol>
10-
<li><a href="{@docRoot}guide/topics/ui/themes.html">Applying Styles and Themes</a></li>
10+
<li><a href="{@docRoot}guide/topics/ui/themes.html">Styles and Themes</a></li>
1111
</ol>
1212
</div>
1313
</div>
@@ -18,7 +18,7 @@ A style can be applied to an individual {@link android.view.View} (from within a
1818
an entire {@link android.app.Activity} or application (from within the manifest file).</p>
1919

2020
<p>For more information about creating and applying styles, please read
21-
<a href="{@docRoot}guide/topics/ui/themes.html">Applying Styles and Themes</a>.</p>
21+
<a href="{@docRoot}guide/topics/ui/themes.html">Styles and Themes</a>.</p>
2222

2323
<p class="note"><strong>Note:</strong> A style is a simple resource that is referenced
2424
using the value provided in the {@code name} attribute (not the name of the XML file). As

0 commit comments

Comments
 (0)