Dan Morrill | 3cd199f | 2009-11-06 14:04:16 -0800 | [diff] [blame] | 1 | page.title=Community |
| 2 | doc.type=community |
Gaurav Mathur | b8d30c1 | 2009-08-11 17:52:01 -0700 | [diff] [blame] | 3 | @jd:body |
Dan Morrill | 3cd199f | 2009-11-06 14:04:16 -0800 | [diff] [blame] | 4 | <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, |
| 7 | Android communicates via mailing lists. Because Android is an extremely large |
| 8 | project with many components, we have many discussion forums, each focusing on |
| 9 | a different topic.</p> |
| 10 | <p>Please check out the groups below, and join any that seem interesting to |
| 11 | you. Note that if you're a user looking for help with your Android device, |
| 12 | this page probably isn't for you; you should contact your carrier or retailer |
| 13 | for help with your phone.</p> |
| 14 | <p>Please note that if you're looking for information about building |
| 15 | applications for Android, you can find a separate set of groups for those at |
| 16 | our sister site, developer.android.com: <a |
| 17 | href="http://developer.android.com/community/index.html">http://developer.android.com/community/index.html</a></p> |
Gaurav Mathur | b8d30c1 | 2009-08-11 17:52:01 -0700 | [diff] [blame] | 18 | |
Dan Morrill | 3cd199f | 2009-11-06 14:04:16 -0800 | [diff] [blame] | 19 | <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 Morrill | a9788cd | 2009-11-15 11:49:30 -0800 | [diff] [blame] | 37 | |
Dan Morrill | 3cd199f | 2009-11-06 14:04:16 -0800 | [diff] [blame] | 38 | <h2>Open Source Project discussions</h2> |
| 39 | <ul> |
Dan Morrill | a9788cd | 2009-11-15 11:49:30 -0800 | [diff] [blame] | 40 | <li><b>android-building</b><br/> |
| 41 | Subscribe to this list for discussion and help on building the Android source |
| 42 | code, and on the build system. If you've just checked out the source code and |
| 43 | have questions about how to turn it into binaries, start here.<br/><br/> |
| 44 | Subscribe using Google Groups: <a |
| 45 | href="http://groups.google.com/group/android-building">android-building</a><br/> |
| 46 | Subscribe via email: <a href="mailto:android-building+subscribe@googlegroups.com">android-building+subscribe@googlegroups.com</a> |
| 47 | </li> |
| 48 | |
Dan Morrill | 3cd199f | 2009-11-06 14:04:16 -0800 | [diff] [blame] | 49 | <li><b>android-porting</b><br/> |
| 50 | This list is for developers who want to port Android to a new device. If |
| 51 | you're wondering how to combine the Android source code with your hardware, |
| 52 | this is the right group for you. Discuss here the specifics of porting Android |
| 53 | to individual devices, from obtaining toolchains and merging kernel drivers |
| 54 | all the way to configuring or modifying applications for your specific |
| 55 | configuration.<br/><br/> |
| 56 | Subscribe using Google Groups: <a |
| 57 | href="http://groups.google.com/group/android-porting">android-porting</a><br/> |
| 58 | Subscribe via email: <a href="mailto:android-porting+subscribe@googlegroups.com">android-porting+subscribe@googlegroups.com</a> |
| 59 | </li> |
| 60 | |
Dan Morrill | 55de681 | 2009-11-15 15:46:36 -0800 | [diff] [blame] | 61 | <li><b>android-platform</b><br/> |
| 62 | This list is for developers who want to contribute code to the Android |
| 63 | user-space projects, such as the core system libraries, the Android |
| 64 | services, the public APIs, or the built-in applications. Note: contributors |
| 65 | to the Android kernel should go to the android-kernel list, below.<br/><br/> |
| 66 | Subscribe using Google Groups: <a |
| 67 | href="http://groups.google.com/group/android-platform">android-platform</a><br/> |
| 68 | Subscribe via email: <a href="mailto:android-platform+subscribe@googlegroups.com">android-platform+subscribe@googlegroups.com</a> |
| 69 | </li> |
| 70 | |
Dan Morrill | 3cd199f | 2009-11-06 14:04:16 -0800 | [diff] [blame] | 71 | <li><b>android-kernel</b><br/> |
| 72 | This list is for deveopers who want to contribute to the Linux kernel that |
| 73 | Android devices use. If you've downloaded the kernel code, if you know how to |
| 74 | compile it, if you want to write kernel code to specifically support Android, |
| 75 | this is your place. This group isn't for user-space topics (see |
| 76 | android-platform for that), and people will shake their fingers at you and |
| 77 | call you naughty if you ask user-space questions here.<br/><br/> |
| 78 | Subscribe using Google Groups: <a |
| 79 | href="http://groups.google.com/group/android-kernel">android-kernel</a><br/> |
| 80 | Subscribe via email: <a href="mailto:android-kernel+subscribe@googlegroups.com">android-kernel+subscribe@googlegroups.com</a> |
| 81 | </li> |
Dan Morrill | 3cd199f | 2009-11-06 14:04:16 -0800 | [diff] [blame] | 82 | </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> |
| 86 | site, 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 |
| 88 | under "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 |
| 92 | visit <a |
| 93 | href="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 |
| 100 | channels 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 |
| 106 | community is using, but are not official. These aren't official or officially |
| 107 | moderated/managed, so you use the channels below at your own risk. The Open |
| 108 | Handset Alliance doesn't endorse these channels, there's no warranty express |
| 109 | or 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> |