blob: 6e6f59e52b17708a77a13cebc7014f6314d382d3 [file] [log] [blame]
Dan Morrill3cd199f2009-11-06 14:04:16 -08001page.title=Community
2doc.type=community
Gaurav Mathurb8d30c12009-08-11 17:52:01 -07003@jd:body
Dan Morrill3cd199f2009-11-06 14:04:16 -08004<h1>Android Community</h1>
5<p>Welcome to the Android community!</p>
6<p>The key to any community is, obviously, communication. Like most projects,
7Android communicates via mailing lists. Because Android is an extremely large
8project with many components, we have many discussion forums, each focusing on
9a different topic.</p>
10<p>Please check out the groups below, and join any that seem interesting to
11you. Note that if you're a user looking for help with your Android device,
12this page probably isn't for you; you should contact your carrier or retailer
13for help with your phone.</p>
14<p>Please note that if you're looking for information about building
15applications for Android, you can find a separate set of groups for those at
16our sister site, developer.android.com: <a
17href="http://developer.android.com/community/index.html">http://developer.android.com/community/index.html</a></p>
Gaurav Mathurb8d30c12009-08-11 17:52:01 -070018
Dan Morrill3cd199f2009-11-06 14:04:16 -080019<h2>Getting the Most from Our Lists</h2>
20<p>Please consider the following before you post to our lists.</p>
21<ol>
22 <li><b>Read the <a
23 href="{@docRoot}community/groups-charter.html">Charter
24 for our forums.</a></b> This explains the (few) rules and guidelines for our
25 community.<br></li>
26 <li><b>Search the group archives to see whether your questions have already
27 been discussed.</b></li> This avoids time-wasting redundant discussions.
28 <li><b>Use a clear, relevant message subject.</b> This helps everyone,
29 both those trying to answer your question as well as those who may be
30 looking for information in the future.</li>
31 <li><b>Give plenty of details in your post.</b> Code or log snippets,
32 pointers to screenshots, and similar details will get better results and
33 make for better discussions. For a great guide to phrasing your questions,
34 read <a href="http://www.catb.org/%7Eesr/faqs/smart-questions.html">How To
35 Ask Questions The Smart Way</a>.</li>
36</ol>
Dan Morrilla9788cd2009-11-15 11:49:30 -080037
Dan Morrill3cd199f2009-11-06 14:04:16 -080038<h2>Open Source Project discussions</h2>
39<ul>
Dan Morrilla9788cd2009-11-15 11:49:30 -080040<li><b>android-building</b><br/>
41Subscribe to this list for discussion and help on building the Android source
42code, and on the build system. If you've just checked out the source code and
43have questions about how to turn it into binaries, start here.<br/><br/>
44Subscribe using Google Groups: <a
45href="http://groups.google.com/group/android-building">android-building</a><br/>
46Subscribe via email: <a href="mailto:android-building+subscribe@googlegroups.com">android-building+subscribe@googlegroups.com</a>
47</li>
48
Dan Morrill3cd199f2009-11-06 14:04:16 -080049<li><b>android-porting</b><br/>
50This list is for developers who want to port Android to a new device. If
51you're wondering how to combine the Android source code with your hardware,
52this is the right group for you. Discuss here the specifics of porting Android
53to individual devices, from obtaining toolchains and merging kernel drivers
54all the way to configuring or modifying applications for your specific
55configuration.<br/><br/>
56Subscribe using Google Groups: <a
57href="http://groups.google.com/group/android-porting">android-porting</a><br/>
58Subscribe via email: <a href="mailto:android-porting+subscribe@googlegroups.com">android-porting+subscribe@googlegroups.com</a>
59</li>
60
Dan Morrill55de6812009-11-15 15:46:36 -080061<li><b>android-platform</b><br/>
62This list is for developers who want to contribute code to the Android
63user-space projects, such as the core system libraries, the Android
64services, the public APIs, or the built-in applications. Note: contributors
65to the Android kernel should go to the android-kernel list, below.<br/><br/>
66Subscribe using Google Groups: <a
67href="http://groups.google.com/group/android-platform">android-platform</a><br/>
68Subscribe via email: <a href="mailto:android-platform+subscribe@googlegroups.com">android-platform+subscribe@googlegroups.com</a>
69</li>
70
Dan Morrill3cd199f2009-11-06 14:04:16 -080071<li><b>android-kernel</b><br/>
72This list is for deveopers who want to contribute to the Linux kernel that
73Android devices use. If you've downloaded the kernel code, if you know how to
74compile it, if you want to write kernel code to specifically support Android,
75this is your place. This group isn't for user-space topics (see
76android-platform for that), and people will shake their fingers at you and
77call you naughty if you ask user-space questions here.<br/><br/>
78Subscribe using Google Groups: <a
79href="http://groups.google.com/group/android-kernel">android-kernel</a><br/>
80Subscribe via email: <a href="mailto:android-kernel+subscribe@googlegroups.com">android-kernel+subscribe@googlegroups.com</a>
81</li>
Dan Morrill3cd199f2009-11-06 14:04:16 -080082</ul>
83
84<h2>Using email with Google Groups</h2>
85<p>Instead of using the <a href="http://groups.google.com/">Google Groups</a>
86site, you can use your email client of choice to participate in the mailing lists.</p>
87<p>To subscribe to a group without using the Google Groups site, use the link
88under "subscribe via email" in the lists above.</p>
89<p>To set up how you receive mailing list postings by email:</p>
90<ol>
91<li>Sign into the group via the Google Groups site. For example, for the android-framework group you would
92visit <a
93href="http://groups.google.com/group/android-framework">http://groups.google.com/group/android-framework</a>.</li>
94<li>Click "Edit my membership" on the right side.</li>
95<li>Under "How do you want to read this group?" select one of the email options.</li>
96</ol>
97
98<h2>Android on IRC</h2>
99<p>We also have a presence on IRC via Freenode. We maintain two official IRC
100channels on irc.freenode.net:</p>
101<ul>
102<li><b>#android</b> - dedicated to general Android discussion and porting concerns</li>
103<li><b>#android-dev</b> - dedicated to discussion about writing Android applications</li>
104</ul>
105<p>The channels above are official. There are a few other channels the
106community is using, but are not official. These aren't official or officially
107moderated/managed, so you use the channels below at your own risk. The Open
108Handset Alliance doesn't endorse these channels, there's no warranty express
109or implied, and so on. There may be more.</p>
110<ul>
111<li><b>#android-offtopic</b> - for, well, off-topic discussions</li>
112<li><b>#android-root</b> - for discussion related to off-label uses of hardware</li>
113<li><b>#androidfra</b> - pour discuter d'Android en français</li>
114</ul>