docs: Preview 3 - Support page updates

- Add Key changes
- Add Known issues

Change-Id: I080b191a6609a4216e7521afa951b53f33609b90

5 files changed, 61 insertions, 78 deletions

diff --git a/docs/html/preview/api-overview.jd b/docs/html/preview/api-overview.jd
index e15a657..55829d3 100644
--- a/docs/html/preview/api-overview.jd
+++ b/docs/html/preview/api-overview.jd
@@ -45,7 +45,7 @@ page.image=images/cards/card-api-overview_16-9_2x.png
 
 <h2>API Differences</h2>
 <ol>
-<li><a href="{@docRoot}preview/download.html">API level 22 to M Preview &raquo;</a> </li>
+<li><a href="{@docRoot}sdk/api_diff/23/changes.html">API level 22 to 23 (Preview 3) &raquo;</a> </li>
 </ol>
 
 </div>
@@ -55,21 +55,27 @@ page.image=images/cards/card-api-overview_16-9_2x.png
 for the Android platform, which offers new features for users and app
 developers. This document provides an introduction to the most notable APIs.</p>
 
-<p>The M Developer Preview is intended for <strong>developer early
-adopters</strong> and <strong>testers</strong>. If you are interested in
-influencing the direction of the Android framework,
-<a href="{@docRoot}preview/setup-sdk.html">give the M Developer Preview a
-try</a> and send us your feedback!</p>
-
-<p class="caution"><strong>Caution:</strong> Do not publish apps
-that use the M Developer Preview to the Google Play store.</p>
-
-<p class="note"><strong>Note:</strong> This document often refers to classes and
-methods that do not yet have reference material available on <a
-href="{@docRoot}">developer.android.com</a>. These API elements are
-formatted in {@code code style} in this document (without hyperlinks). For the
-preliminary API documentation for these elements, download the <a
-href="{@docRoot}preview/download.html#docs"> preview reference</a>.</p>
+<p>
+  The M Developer Preview 3 release includes the <strong>final APIs for Android 6.0 (API level
+  23)</strong>. If you are preparing an app for use on Android 6.0,
+  <a href="{@docRoot}preview/setup-sdk.html">download the latest SDK</a> and to complete your
+  final updates and release testing. You can review the final APIs in the
+  <a href="{@docRoot}reference/packages.html">API Reference</a> and see the API differences in
+  the <a href="{@docRoot}sdk/api_diff/23/changes.html">Android API Differences Report</a>.
+</p>
+
+</p>
+
+<p class="caution"><strong>Important:</strong>
+  You may now publish apps that target Android 6.0 (API level 23) to the Google Play store.
+</p>
+
+<p class="note"><strong>Note:</strong>
+  If you have been working with previous preview releases and want to see the differences
+  between the final API and previous preview versions, download the additional difference
+  reports included in the <a href="{@docRoot}preview/download.html#docs">preview docs
+  reference</a>.
+</p>
 
 <h3>Important behavior changes</h3>
 
diff --git a/docs/html/preview/download_mp1.jd b/docs/html/preview/download_mp1.jd
index cb4d300..5838f20 100644
--- a/docs/html/preview/download_mp1.jd
+++ b/docs/html/preview/download_mp1.jd
@@ -1,4 +1,4 @@
-page.title=Developer Preview Archive
+page.title=Developer Preview 1 Archive
 page.image=images/cards/card-download_16-9_2x.png
 
 @jd:body
diff --git a/docs/html/preview/download_mp2.jd b/docs/html/preview/download_mp2.jd
index 0dfabef..0208b5e 100644
--- a/docs/html/preview/download_mp2.jd
+++ b/docs/html/preview/download_mp2.jd
@@ -1,4 +1,4 @@
-page.title=Downloads
+page.title=Developer Preview 2 Archive
 page.image=images/cards/card-download_16-9_2x.png
 
 @jd:body
diff --git a/docs/html/preview/setup-sdk.jd b/docs/html/preview/setup-sdk.jd
index d3327e8..a4d9418 100644
--- a/docs/html/preview/setup-sdk.jd
+++ b/docs/html/preview/setup-sdk.jd
@@ -16,56 +16,30 @@ page.image=images/cards/card-set-up_16-9_2x.png
   </div>
 </div>
 
-<p>The M Developer Preview SDK is available from the Android SDK Manager.
-This document assumes that you are familiar with Android app development, such
+<p>With Developer Preview 3, the official Android 6.0 SDK is now available from the Android SDK
+Manager. This document assumes that you are familiar with Android app development, such
 as using the Android SDK Manager and creating projects. If you are new to
 Android, see <a href="{@docRoot}training/basics/firstapp/index.html">Building Your First
-App</a> training lesson first.</a></p>
+App</a> training lesson first.</p>
 
-<h2 id="get-as13">Get Android Studio 1.3</h2>
-
-<p>The Developer Preview is best used with Android Studio 1.3, which is in
-preview status. It is highly recommended that you install the preview version of
-Android Studio 1.3 to work with the Preview SDK.</p>
-
-<p class="caution"><strong>Caution:</strong> The canary preview of Android
-Studio 1.3 is still in active development. If you are using your primary development
-machine to test the developer preview, you can create a second installation
-of Android Studio to use for testing.</p>
 
-<p>To install the Android Studio 1.3 preview:</p>
-
-<ol>
-  <li>Download and launch <a href="{@docRoot}tools/studio/index.html">Android
-  Studio</a>.
-  </li>
-
-  <li>Open the <strong>Settings</strong> window (on Windows, you can do this
-  by choosing <strong>File &gt; Settings</strong>). Choose the
-  <strong>Appearance &amp; Behavior &gt; System
-  Settings &gt; Updates</strong> panel.
-
-    <p class="aside">On OSX, you can find the <strong>Appearance &amp;
-    Behavior</strong> panel
-    in Android Studio's <strong>Preferences</strong> window.</p>
-  </li>
+<h2 id="get-as13">Get Android Studio 1.3</h2>
 
-  <li> On the <strong>Updates</strong> panel, choose the option
-  <strong>Automatically check updates for: Canary Channel</strong>.
-  </li>
+<p>
+  The Developer Preview is best used with Android Studio 1.3. It is highly recommended that
+  you install the Android Studio 1.3 to work with the Preview SDK and the final Android 6.0 SDK
+  provided with Preview 3. Please update your Android Studio installation to version 1.3 or
+  higher, or follow the instructions for
+  <a href="{@docRoot}sdk/installing/index.html?pkg=studio">Installing Android Studio</a>.
+</p>
 
-  <li>On the <strong>Updates</strong> panel, select <strong>Check Now</strong>
-  to check for the latest canary build. Download and install the build when you
-  are prompted.
-  </li>
-</ol>
 
 <h2 id="get-sdk">Get the Preview SDK</h2>
 
 <p>To add the Preview SDK components to your development environment:</p>
 
 <ol>
-  <li>Launch the Android Studio 1.3 preview.
+  <li>Launch Android Studio 1.3 or higher.
   </li>
 
   <li>Open the <strong>Settings</strong> window (on Windows, you can do this
@@ -73,13 +47,12 @@ of Android Studio to use for testing.</p>
   <strong>Appearance &amp; Behavior &gt; System
   Settings &gt; Updates</strong> panel.
 
-    <p class="aside">On OSX, you can find the <strong>Appearance &amp;
+    <p class="aside">On Mac OS X, you can find the <strong>Appearance &amp;
     Behavior</strong> panel
     in Android Studio's <strong>Preferences</strong> window.</p>
   </li>
 
-  <li>On the <strong>Updates</strong> panel, choose the options
-  <strong>Automatically check updates for: Canary Channel</strong> and
+  <li>On the <strong>Updates</strong> panel, choose the option for
   <strong>Automatically check updates for Android SDK: Preview Channel</strong>.
   </li>
 
@@ -135,7 +108,7 @@ of Android Studio to use for testing.</p>
 
 <ul>
   <li>Check <strong>Phone and Tablet</strong>.</li>
-  <li>Select <strong>MNC: Android M (Preview)</strong> in <strong>Minimum
+  <li>Select <strong>API 23: Android 6.0 (Marshmallow)</strong> in <strong>Minimum
     SDK</strong>.</li>
 </ul>
 
@@ -149,9 +122,8 @@ of Android Studio to use for testing.</p>
 </p>
 
 <ul>
-  <li><code>compileSdkVersion</code> is set to <code>'android-MNC'</code></li>
-  <li><code>minSdkVersion</code> is set to <code>'MNC'</code></li>
-  <li><code>targetSdkVersion</code> is set to <code>'MNC'</code></li>
+  <li><code>compileSdkVersion</code> is set to <code>'23'</code></li>
+  <li><code>targetSdkVersion</code> is set to <code>'23'</code></li>
 </ul>
 
 
diff --git a/docs/html/preview/support.jd b/docs/html/preview/support.jd
index a3bfe7e..49d4906 100644
--- a/docs/html/preview/support.jd
+++ b/docs/html/preview/support.jd
@@ -57,7 +57,7 @@ page.image=images/cards/card-support_16-9_2x.png
     <div class="col-9of16">
       <p>
         <em>Date: August 2015<br>
-        Builds: XXXXXX (Nexus 5, 6, 9), XXXXXX (Nexus Player)<br>
+        Build: MPA44G<br>
         Hardware support: Nexus 5, 6, 9, Player<br>
         Emulator support: x86 &amp; ARM 32/64-bit<br>
         Google Play services: 7.8</em>
@@ -70,7 +70,7 @@ page.image=images/cards/card-support_16-9_2x.png
   Developer Preview 3 is the <strong>final incremental update</strong>
   to the Android M preview platform that was originally released in May 2015.
   The update includes <strong>final APIs and the official Android 6.0 SDK</strong>,
-  as well as <strong>near-final system images</strong> for testing your apps. The
+  as well as near-final system images for testing your apps. The
   updated system images bring a variety of fixes and enhancements across
   the system, including those related to issues reported by developers
   through the external issue tracker.
@@ -95,7 +95,7 @@ page.image=images/cards/card-support_16-9_2x.png
 </h3>
 
 <p>
-  Developer Preview 3 includes the official Android 6.0 
+  Developer Preview 3 includes the official Android 6.0
   SDK as well as updated preview system images, documentation,
   and samples for developing against the Android 6.0
   development platform.
@@ -134,7 +134,7 @@ page.image=images/cards/card-support_16-9_2x.png
       <li>
         <a href=
         "https://github.com/googlesamples/android-RuntimePermissions">RuntimePermissions</a>
-        / <a href=
+        and <a href=
         "https://github.com/googlesamples/android-RuntimePermissionsBasic">RuntimePermissionsBasic</a>
         are updated to reflect latest permissions API changes, including
         <code>shouldShowRequestPermissionRationale()</code>.
@@ -151,16 +151,18 @@ page.image=images/cards/card-support_16-9_2x.png
 </h3>
 
 <ul>
-  <li>Add here
+  <li>Permission changes
     <ul>
-      <li>
+      <li>The {@link android.Manifest.permission#GET_ACCOUNTS} permission is now a member of the
+        {@link android.Manifest.permission_group#CONTACTS} permission group and it has a
+        {@code android:protectionLevel} of {@code dangerous}. This change means that when
+        targeting Android 6.0 (API level 23), you must check for and request this permission if
+        your app requires it.
       </li>
-    </ul>
-  </li>
 
-  <li>Other changes
-    <ul>
-      <li>
+      <li>The {@code android.permission.READ_PROFILE} and {@code android.permission.WRITE_PROFILE}
+       permissions have been removed from the {@link android.Manifest.permission_group#CONTACTS}
+       permission group.
       </li>
     </ul>
   </li>
@@ -178,7 +180,10 @@ page.image=images/cards/card-support_16-9_2x.png
 <ul>
   <li>General issues:
     <ul>
-      <li>Add
+      <li>On LTE devices, including volantis, GPS is not functioning properly, which may
+        interfere with navigation services.
+      </li>
+      <li>During Hangouts calls, users may experience distorted or low audio on some devices.
       </li>
     </ul>
   </li>
@@ -314,7 +319,7 @@ page.image=images/cards/card-support_16-9_2x.png
   </li>
 </ul>
 
-<h3 id="changes">
+<h3 id="changes-p2">
   Key changes
 </h3>
 
@@ -405,7 +410,7 @@ page.image=images/cards/card-support_16-9_2x.png
   "{@docRoot}preview/download.html#docs">Developer Documentation download package</a>.
 </p>
 
-<h3 id="ki">
+<h3 id="ki-p2">
   Known issues
 </h3>
 
@@ -463,7 +468,7 @@ page.image=images/cards/card-support_16-9_2x.png
   Developer Preview 2 system images for supported Nexus devices are available
   by download and by over-the-air (OTA) update. The OTA update is available
   only to supported devices that are currently running Developer Preview 1. If
-  your devices is running Developer Preview 1, you should automatically receive
+  your devices are running Developer Preview 1, you should automatically receive
   the OTA update within a few days of availability.
 </p>