docs only.

add information on provisional api level
and fix some link titles

Change-Id: If208ff3fc4bb169049484311422f772334c0ef1b

1 files changed, 25 insertions, 3 deletions

diff --git a/docs/html/guide/appendix/api-levels.jd b/docs/html/guide/appendix/api-levels.jd
index acf6899..3158192 100644
--- a/docs/html/guide/appendix/api-levels.jd
+++ b/docs/html/guide/appendix/api-levels.jd
@@ -7,17 +7,18 @@ page.title=Android API Levels
   <h2>In this document</h2>
 <ol>
   <li><a href="intro">What is API Level?</a></li>
-  <li><a href="#uses">Uses of API Level</a></li>
+  <li><a href="#uses">Uses of API Level in Android</a></li>
   <li><a href="#considerations">Development Considerations</a>
     <ol>
       <li><a href="#fc">Application forward compatibility</a></li>
       <li><a href="#bc">Application backward compatibility</a></li>
-      <li><a href="#platform">Selecting a platform version for compiling</a></li>
+      <li><a href="#platform">Selecting a platform version and API Level</a></li>
       <li><a href="#apilevel">Declaring a minimum API Level</a></li>
       <li><a href="#testing">Testing against higher API Levels</a></li>
     </ol>
   </li>
-  <li><a href="#filtering">Filtering the documentation</a></li>
+  <li><a href="#provisional">Using a Provisional API Level</a></li>
+  <li><a href="#filtering">Filtering the Reference Documentation by API Level</a></li>
 </ol>
 
   <h2>See also</h2>
@@ -285,6 +286,27 @@ of the Android platform it runs. See the table at the top of this document for
 a list of platform versions and their API Levels. </p>
 
 
+<h2 id="provisional">Using a Provisional API Level</h2>
+
+<p>During an "Early Look" SDK release, the APIs may not be final, so the API Level integer
+will not be specified. You must instead use a provisional API Level in your application
+manifest in order to build applications against the Early Look platform. In this case,
+the provisional API Level is not an integer, but a string matching the codename of the
+unreleased platform version (for example, "Eclair"). The provisional API Level will be specified
+in the Early Look SDK release notes and is case-sensitive.</p>
+
+<p>The use of a provisional API Level is designed to protect developers 
+and device users from inadvertently publishing or installing applications based on the 
+Early Look framework API, which may not run properly on actual devices running the final
+system image.</p>
+
+<p>The provisional API Level will only be valid while using the Early Look SDK to run
+applications in the emulator. An application using the provisional API Level can never be 
+installed on an Android device. When the final SDK is released, you must replace any
+instances of the provisional API Level in your application manifest with the final 
+API Level integer.</p>
+
+
 <h2 id="filtering">Filtering the Reference Documentation by API Level</h2>
 
 <p>Reference documentation pages on the Android Developers site offer a "Filter