summaryrefslogtreecommitdiffstats
path: root/docs/html/guide/index.jd
diff options
context:
space:
mode:
Diffstat (limited to 'docs/html/guide/index.jd')
-rw-r--r--docs/html/guide/index.jd142
1 files changed, 82 insertions, 60 deletions
diff --git a/docs/html/guide/index.jd b/docs/html/guide/index.jd
index e723235..ecbf97b 100644
--- a/docs/html/guide/index.jd
+++ b/docs/html/guide/index.jd
@@ -1,62 +1,84 @@
-page.title=Get Started
+page.title=The Developer's Guide
@jd:body
-<p>Welcome to the Android Developer Guide! The <strong>Dev Guide</strong> is your conceptual and practical
-introduction to developing applications for Android. With this guide, you're free to explore
-which ever topics interest you, based on your goals and experience.</p>
-
-<p>If you're new to Android, you're probably wondering what it takes to
-write a "Hello, World" application. So here it is:</p>
-
-<pre>
-package com.example.hello;
-
-import android.app.Activity;
-import android.os.Bundle;
-import android.widget.TextView;
-
-public class HelloWorld extends Activity {
-
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- TextView tv = new TextView(this);
- tv.setText(&quot;Hello, World&quot;);
- setContentView(tv);
- }
-
-}
-</pre>
-
-<p>That's the only code you need to write!</p>
-
-<h2 class="small-header">Not convinced?</h2>
-<p>If you're still shouting "Show me the code!" then take a look at
-more Android code in the <a href="{@docRoot}guide/tutorials/hello-world/index.html">Hello World Samples</a>.</p>
-
-<h2 class="small-header">Ready to start?</h2>
-<p>If you're already convinced you want to develop on Android,
-then we'll teach you how to build and run this "Hello, World" application in the
-<a href="{@docRoot}guide/tutorials/hello-world.html">Hello World Introduction</a>.</p>
-
-<h2 class="small-header">Ready for more?</h2>
-<p>Once you've got your feet wet (or just want to skip to the heart of Android), the following
-sections of the Dev Guide will educate you on the Android ins, outs, idioms and techniques:</p>
-<ul>
- <li><em>Android Basics</em>:
- Learn more about what Android is, what it offers, and how your application fits in.</li>
- <li><em>Framework Topics</em>:
- Become well versed in the practical matters of developing on Android &mdash; from drawing a UI, to storing data,
- to drawing 3D graphics, and much more.</li>
- <li><em>Developing</em>:
- Learn more about developing with IDEs, using Android develop/debug tools, and testing.</li>
- <li><em>Publishing</em>:
- Learn how to get you application out there, for the world to enjoy!</li>
- <li><em>Best Practices</em>:
- Get some recommendations on preferred techniques to write the best applications.</li>
- <li><em>Tutorials</em>:
- Get help doing some of the basics, step by step.</li>
- <li><em>Appendix</em>:
- Flotsam and jetsam. Find some of those spare nuggets of information.</li>
-</ul>
-
-<p>For more help, you should consider joining one or more of the Android discussion groups. See the <a href="{@docRoot}community/index.html">Community</a> for more information.</p>
+<p>
+Welcome to the <i>Android Dev Guide</i>! The Dev Guide is
+a practical introduction to developing applications for Android.
+It explores the concepts behind Android, the framework for
+constructing an application, and the tools for developing,
+testing, and publishing software for the platform.
+</p>
+
+<p>
+The Dev Guide holds most of the documentation for the Android
+platform, except for reference material on the framework API.
+For API specifications, go to the
+<a href="{@docRoot}reference/packages.html">Reference</a> tab above.
+</p>
+
+<p>
+As you can see in the panel on the left, the Dev Guide is
+divided into a handful of sections. They are:
+<p>
+
+<dl>
+<dt><b>Android Basics</b></dt>
+<dd>An initial orientation to Android &mdash; what it is,
+what it offers, and how your application fits in.</dd>
+
+<dt><b>Framework Topics</b></dt>
+<dd>Discussions of particular parts of the Android framework
+and API. For an overview of the framework, begin with
+<a href="{@docRoot}guide/topics/fundamentals.html">Application
+Fundamentals</a>. Then explore other topics &mdash; from
+designing a user interface and setting up resources to storing
+data and using permissions &mdash; as needed.</dd>
+
+<dt><b>Developing</b></dt>
+<dd>Directions for using Android's development and debugging tools,
+and for testing the results.</dd>
+
+<dt><b>Publishing</b></dt>
+<dd>Instructions on how to prepare your application for deployment
+and how to publish it when it's ready.</dd>
+
+<dt><b>Best Practices</b></dt>
+<dd>Recommendations on preferred techniques for writing
+applications that perform efficiently and work well for the
+user.</dd>
+
+<dt><b>Tutorials and Samples</b></dt>
+<dd>Step-by-step tutorials and sample code demonstrating how
+an Android application is constructed.</dd>
+
+<dt><b>Appendix</b></dt>
+<dd>Reference information and specifications, as well as FAQs,
+a glossary of terms, and other information.</dd>
+</dl>
+
+<p>
+The first step in programming for Android is downloading the SDK
+(software development kit). For instructions and information about
+the kit, go to the <a href="{@docRoot}sdk/index.html">SDK</a> tab above.
+</p>
+
+<p>
+After you have the SDK, begin by looking over the Dev Guide.
+If you want to start by getting a quick look at the code, the short
+<a href="{@docRoot}guide/tutorials/hello-world.html">Hello World</a>
+tutorial walks you through a standard "Hello, World" application as
+it would be written for the Android platform. The
+<a href="{@docRoot}guide/topics/fundamentals.html">Application
+Fundamentals</a> document is a good place to start for an
+understanding of the application framework.
+</p>
+
+
+<p>
+For additional help, consider joining one or more of the Android
+discussion groups. Go to the
+<a href="{@docRoot}community/index.html">Community</a> tab above
+for more information.
+</p>
+
+<p>To return to this page later, just click the "Dev Guide" tab while any Dev Guide page is loaded. </p> \ No newline at end of file