Cleaning up source.android.com files.
This change fixes some formatting artifacts that resulted from the export from
Sites, and also updates links to no longer point to Sites and use the standard
{@docRoot} idiom. Also contains a few content updates, and introduces a page
about branch management.
diff --git a/pdk/docs/compatibility/index.jd b/pdk/docs/compatibility/index.jd
index 9f62872..0c39a98 100644
--- a/pdk/docs/compatibility/index.jd
+++ b/pdk/docs/compatibility/index.jd
@@ -2,10 +2,16 @@
doc.type=compatibility
@jd:body
<p>Android is an open source product, and anyone can use the source code to build
-devices. Incautious implementations, however, can easily introduce bugs that
-cause third-party applications to break. The purpose of the Android
-Compatibility Program is to help Android device implementations remain
-compatible with all apps.</p>
+devices. The purpose of the Android compatibility program is to help Android
+device implementations remain compatible with all apps.</p>
+<p>A device is considered compatible if existing and new third-party
+applications run correctly on it. Poor device implementations that change APIs
+or alter behaviors will break these apps and so are not compatible. The
+Android compatibility program's aim is to ensure that these APIs are
+consistently implemented across devices.</p>
+<p>The latest version of the Android source code and compatibility program is
+1.6, which roughly corresponded to the Donut branch. The compatibility
+program for Android 2.x (corresponding to Eclair) is coming soon.</p>
<h2>Why build compatible Android devices?</h2>
<h3>Users want a customizable device.</h3>
<p>A mobile phone is a highly personal, always-on, always-present gateway to
@@ -41,7 +47,8 @@
This document enumerates the software and the hardware features of
a compatible Android device.</p></li>
<li><b>Pass the Compatibility Test Suite (CTS)</b><p>You can use the CTS
- as an ongoing aid to compatibility during the development process.</p></li>
+ (included in the Android source code) as an ongoing aid to compatibility
+ during the development process.</p></li>
<li><b>Submit CTS report</b><p>[Optional] You can also submit your CTS report,
so that it can be validated and recorded.</p><p><i>Note:
the submission system is currently under construciton, and is not currently