From d4cc94299613ca73c941e3a9b5ed935f444b963d Mon Sep 17 00:00:00 2001
From: Scott Main <smain@google.com>
Date: Wed, 3 Oct 2012 18:47:08 -0700
Subject: [PATCH] add links from various design docs to corresponding developer
 docs

Change-Id: Id731979a9b6ebcfc956848933d64ea5cf64953b5
---
 docs/html/design/building-blocks/buttons.jd     |  7 +++++++
 docs/html/design/building-blocks/dialogs.jd     | 13 +++++++++++++
 docs/html/design/building-blocks/pickers.jd     |  7 +++++++
 docs/html/design/building-blocks/spinners.jd    |  7 +++++++
 docs/html/design/building-blocks/switches.jd    |  8 ++++++++
 docs/html/design/building-blocks/tabs.jd        |  7 +++++++
 docs/html/design/building-blocks/text-fields.jd |  8 ++++++++
 docs/html/design/patterns/accessibility.jd      |  9 +++++++++
 docs/html/design/patterns/actionbar.jd          | 11 +++++++++++
 docs/html/design/patterns/multi-pane-layouts.jd | 12 ++++++++++++
 docs/html/design/patterns/navigation.jd         | 12 ++++++++++++
 docs/html/design/patterns/notifications.jd      | 11 ++++++++++-
 docs/html/design/patterns/settings.jd           |  9 +++++++++
 docs/html/design/patterns/swipe-views.jd        | 10 ++++++++++
 docs/html/design/patterns/widgets.jd            | 10 +++++++++-
 15 files changed, 139 insertions(+), 2 deletions(-)

diff --git a/docs/html/design/building-blocks/buttons.jd b/docs/html/design/building-blocks/buttons.jd
index 1c28cbefb1172..82e2477c86be5 100644
--- a/docs/html/design/building-blocks/buttons.jd
+++ b/docs/html/design/building-blocks/buttons.jd
@@ -36,3 +36,10 @@ use borderless buttons with both icons and text. Borderless buttons are visually
 than basic buttons and integrate nicely with other content.</p>
 
 <img src="{@docRoot}design/media/buttons_borderless.png">
+
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to build and customize buttons in your app,
+  see the <a href="{@docRoot}guide/topics/ui/controls/button.html">Buttons</a> API guide.</p>
+</div>
diff --git a/docs/html/design/building-blocks/dialogs.jd b/docs/html/design/building-blocks/dialogs.jd
index 728821e211625..a2ece2ea5cce9 100644
--- a/docs/html/design/building-blocks/dialogs.jd
+++ b/docs/html/design/building-blocks/dialogs.jd
@@ -122,6 +122,12 @@ available based on the title and the text of the action buttons.</p>
   </div>
 </div>
 
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to build dialogs in your app,
+  see the <a href="{@docRoot}guide/topics/ui/dialogs.html">Dialogs</a> API guide.</p>
+</div>
+
 <h2 id="popups">Popups</h2>
 
 <p>Popups are lightweight version of dialogs that require a single selection from the user. Popups
@@ -150,3 +156,10 @@ continue editing later. Toasts automatically disappear after a timeout.</p>
 
   </div>
 </div>
+
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to create toasts,
+  see the <a href="{@docRoot}guide/topics/ui/notifiers/toasts.html">Toasts</a> API guide.</p>
+</div>
diff --git a/docs/html/design/building-blocks/pickers.jd b/docs/html/design/building-blocks/pickers.jd
index e3cf6424c7e30..b328df90548b5 100644
--- a/docs/html/design/building-blocks/pickers.jd
+++ b/docs/html/design/building-blocks/pickers.jd
@@ -29,3 +29,10 @@ app helps ensure that a user's specification of a data or time input is valid an
 correctly. The format of a time and date picker adjusts automatically to the locale.</p>
 
 <img src="{@docRoot}design/media/picker_datetime.png">
+
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to create date and time pickers,
+  see the <a href="{@docRoot}guide/topics/ui/controls/pickers.html">Pickers</a> API guide.</p>
+</div>
diff --git a/docs/html/design/building-blocks/spinners.jd b/docs/html/design/building-blocks/spinners.jd
index 621a57ce74413..279565f88fa40 100644
--- a/docs/html/design/building-blocks/spinners.jd
+++ b/docs/html/design/building-blocks/spinners.jd
@@ -35,3 +35,10 @@ tabs.</p>
 <div class="figure-caption">
   Spinners in the Holo Dark and Holo Light themes, in various states.
 </div>
+
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to create spinners,
+  see the <a href="{@docRoot}guide/topics/ui/controls/spinner.html">Spinners</a> API guide.</p>
+</div>
diff --git a/docs/html/design/building-blocks/switches.jd b/docs/html/design/building-blocks/switches.jd
index c4dfc4bdeb9fe..d9cfd07fd3794 100644
--- a/docs/html/design/building-blocks/switches.jd
+++ b/docs/html/design/building-blocks/switches.jd
@@ -23,3 +23,11 @@ consider a spinner, which uses less space.</p>
 <p>On/off switches toggle the state of a single settings option.</p>
 
   <img src="{@docRoot}design/media/switches_switches.png">
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to create these different switches,
+  see the <a href="{@docRoot}guide/topics/ui/controls/checkbox.html">Checkboxes</a>,
+  <a href="{@docRoot}guide/topics/ui/controls/radiobutton.html">Radio Buttons</a>, or
+  <a href="{@docRoot}guide/topics/ui/controls/togglebutton.html">Toggle Buttons</a> API guides.</p>
+</div>
diff --git a/docs/html/design/building-blocks/tabs.jd b/docs/html/design/building-blocks/tabs.jd
index fe05f80a62725..0a0f9077981b6 100644
--- a/docs/html/design/building-blocks/tabs.jd
+++ b/docs/html/design/building-blocks/tabs.jd
@@ -57,3 +57,10 @@ to the next/previous view, swipe left or right.</p>
 permits fast view switching even on narrower screens.</p>
 
 <img src="{@docRoot}design/media/tabs_stacked.png">
+
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to create tabs,
+  see the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> API guide.</p>
+</div>
diff --git a/docs/html/design/building-blocks/text-fields.jd b/docs/html/design/building-blocks/text-fields.jd
index 1b10420db4f37..563f2475ae4e0 100644
--- a/docs/html/design/building-blocks/text-fields.jd
+++ b/docs/html/design/building-blocks/text-fields.jd
@@ -68,3 +68,11 @@ Selection mode includes:</p>
 
   </div>
 </div>
+
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to create text fields, provide auto-complete suggestions,
+  and specify the input mode,
+  see the <a href="{@docRoot}guide/topics/ui/controls/text.html">Text Fields</a> API guide.</p>
+</div>
diff --git a/docs/html/design/patterns/accessibility.jd b/docs/html/design/patterns/accessibility.jd
index b2fbda97c9d7a..2c3333f4d6ac3 100644
--- a/docs/html/design/patterns/accessibility.jd
+++ b/docs/html/design/patterns/accessibility.jd
@@ -69,6 +69,15 @@ page.title=Accessibility
 <h4>Try it out yourself</h4>
 <p>Turn on the TalkBack service in <strong>Settings > Accessibility</strong> and navigate your application using directional controls or eyes-free navigation.</p>
 
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to properly implement accessibility in your app, see the
+  <a href="{@docRoot}guide/topics/ui/accessibility/index.html">Accessibility</a>
+  API guide.</p>
+</div>
+
+
 <h2>Checklist</h2>
 <ul>
   <li>Make navigation intuitive</li>
diff --git a/docs/html/design/patterns/actionbar.jd b/docs/html/design/patterns/actionbar.jd
index 353cee6a3cecd..265ccde1bc6df 100644
--- a/docs/html/design/patterns/actionbar.jd
+++ b/docs/html/design/patterns/actionbar.jd
@@ -349,6 +349,17 @@ sharing options.</p>
   The Gallery app's share action provider with extended spinner for additional sharing options.
 </div>
 
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to build an action bar
+  see the <a href="{@docRoot}guide/topics/ui/actionbar.html">Action Bar</a> API guide.
+  For information about contextual action bars, read
+  <a href="{@docRoot}guide/topics/ui/menus.html#context-menu">Creating Contextual Menus</a>.
+  </p>
+</div>
+
+
 <h2 id="checklist">Action Bar Checklist</h2>
 
 <p>When planning your split action bars, ask yourself questions like these:</p>
diff --git a/docs/html/design/patterns/multi-pane-layouts.jd b/docs/html/design/patterns/multi-pane-layouts.jd
index ad888e9bc0fef..e607676152e05 100644
--- a/docs/html/design/patterns/multi-pane-layouts.jd
+++ b/docs/html/design/patterns/multi-pane-layouts.jd
@@ -86,6 +86,18 @@ you can use to adjust the layout after orientation change while keeping function
   </div>
 </div>
 
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to create multi-pane layouts, read
+  see the <a href="{@docRoot}training/basics/fragments/index.html">Building
+  a Dynamic UI with Fragments</a> and
+  <a href="{@docRoot}training/multiscreen/index.html">Designing for Multiple Screens</a>.
+  </p>
+</div>
+
+
+
 <h2 id="checklist">Checklist</h2>
 
 <ul>
diff --git a/docs/html/design/patterns/navigation.jd b/docs/html/design/patterns/navigation.jd
index 7e288aeaad5b6..656e6e5338fa4 100644
--- a/docs/html/design/patterns/navigation.jd
+++ b/docs/html/design/patterns/navigation.jd
@@ -202,3 +202,15 @@ with Task B&mdash;the prior context is abandoned in favor of the user's new goal
 <p>When your app registers to handle intents with an activity deep within the app's hierarchy,
 refer to <a href="#into-your-app">Navigation into Your App via Home Screen Widgets and
 Notifications</a> for guidance on how to specify Up navigation.</p>
+
+
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to build your app with proper Up and Back navigation, read
+  <a href="{@docRoot}training/implementing-navigation/ancestral.html">Implementing
+  Ancestral Navigation</a> and 
+  <a href="{@docRoot}training/implementing-navigation/temporal.html">Implementing
+  Temporal Navigation</a>, respectively.
+  </p>
+</div>
diff --git a/docs/html/design/patterns/notifications.jd b/docs/html/design/patterns/notifications.jd
index 75bfff290fc0f..1a15a648aeba3 100644
--- a/docs/html/design/patterns/notifications.jd
+++ b/docs/html/design/patterns/notifications.jd
@@ -250,4 +250,13 @@ develop a widget that they can choose to place on their home screen.</p>
     <h4>Dialogs and toasts are for feedback not notification</h4>
     <p>Your app should not create a dialog or toast if it is not currently on screen. Dialogs and Toasts should only be displayed as the immediate response to the user taking an action inside of your app. For further guidance on the use of dialogs and toasts, refer to <a href="{@docRoot}design/patterns/confirming-acknowledging.html">Confirming &amp; Acknowledging</a>.</p>
   </div>
-</div>
\ No newline at end of file
+</div>
+
+
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to build notifications, see the
+  <a href="{@docRoot}guide/topics/ui/notifiers/notifications.html">Notifications</a>
+  API guide.</p>
+</div>
diff --git a/docs/html/design/patterns/settings.jd b/docs/html/design/patterns/settings.jd
index d10f0d3e6eeba..fef7585ac7de2 100644
--- a/docs/html/design/patterns/settings.jd
+++ b/docs/html/design/patterns/settings.jd
@@ -679,6 +679,15 @@ it doesn't mean anything to most users and would have taken up a lot of space.</
   </div>
 </div>
 
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to build a settings interface, see the
+  <a href="{@docRoot}guide/topics/ui/settings.html">Settings</a>
+  API guide.</p>
+</div>
+
+
 <h2 id="checklist">Checklist</h2>
 <ul>
 <li><p>Make sure each item in Settings meets the criteria for belonging there.</p></li>
diff --git a/docs/html/design/patterns/swipe-views.jd b/docs/html/design/patterns/swipe-views.jd
index 252343da8e222..daddd31e47306 100644
--- a/docs/html/design/patterns/swipe-views.jd
+++ b/docs/html/design/patterns/swipe-views.jd
@@ -77,3 +77,13 @@ using the swipe gesture to navigate to the next/previous detail view.</p>
     </ul>
   </div>
 </div>
+
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to create swipe views, read
+  <a href="{@docRoot}training/implementing-navigation/lateral.html">Implementing Lateral Navigation</a>.
+  </p>
+</div>
+
+
diff --git a/docs/html/design/patterns/widgets.jd b/docs/html/design/patterns/widgets.jd
index cf4c74f990e0d..54726b1b530be 100644
--- a/docs/html/design/patterns/widgets.jd
+++ b/docs/html/design/patterns/widgets.jd
@@ -122,7 +122,15 @@ A music player widget is primarily a control widget, but also keeps the user inf
   </div>
 </div>
 
-<h3>Checklist</h3>
+
+<div class="note develop">
+<p><strong>Developer Guide</strong></p>
+  <p>For information about how to build widgets for the home screen, see the
+  <a href="{@docRoot}guide/topics/appwidgets/index.html">App Widgets</a>
+  API guide.</p>
+</div>
+
+<h2>Checklist</h2>
 <ul>
   <li>Focus on small portions of glanceable information on your widget. Expand on the information in your app.</li>
   <li>Choose the right widget type for your purpose.</li>