1<!-- 2 Copyright 2010 The Android Open Source Project 3 4 Licensed under the Apache License, Version 2.0 (the "License"); 5 you may not use this file except in compliance with the License. 6 You may obtain a copy of the License at 7 8 http://www.apache.org/licenses/LICENSE-2.0 9 10 Unless required by applicable law or agreed to in writing, software 11 distributed under the License is distributed on an "AS IS" BASIS, 12 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 See the License for the specific language governing permissions and 14 limitations under the License. 15--> 16 17# Android Community # 18 19Welcome to the Android community! 20 21The key to any community is, obviously, communication. Like most projects, 22Android communicates via mailing lists. Because Android is an extremely large 23project with many components, we have many discussion forums, each focusing on 24a different topic. 25 26Please check out the groups below, and join any that seem interesting to 27you. Note that if you're a user looking for help with your Android device, 28this page probably isn't for you; you should contact your carrier or retailer 29for help with your phone. 30 31Please note that if you're looking for information about building 32applications for Android, you can find a separate set of groups for those at 33our sister site, developer.android.com: [https://developer.android.com/resources/community-groups.html] 34 35## Getting the Most from Our Lists ## 36 37Please consider the following before you post to our lists. 38 39- *Read the [Charter for our forums.](groups-charter.html)* This explains the (few) rules and guidelines for our community. 40 41- *Search the group archives to see whether your questions have already been discussed.* This avoids time-wasting redundant discussions. 42 43- *Use a clear, relevant message subject.* This helps everyone, both those trying to answer your question as well as those who may be looking for information in the future. 44 45- *Give plenty of details in your post.* Code or log snippets, pointers to screenshots, and similar details will get better results and make for better discussions. For a great guide to phrasing your questions, read [How to Ask Questions the Smart Way](http://www.catb.org/%7Eesr/faqs/smart-questions.html). 46<img src="/images/external-link.png"> 47 48## Open Source Project discussions ## 49 50- *android-platform*: 51 This list is for general discussion about the Android open-source project or the platform technologies. 52 - Subscribe using Google Groups: [android-platform](https://groups.google.com/forum/?fromgroups#!forum/android-platform) 53 - Subscribe via email: [android-platform](mailto:android-platform+subscribe@googlegroups.com) 54 55- *android-building*: 56 Subscribe to this list for discussion and help on building the Android source code, and on the build system. If you've just checked out the source code and have questions about how to turn it into binaries, start here. 57 - Subscribe using Google Groups: [android-building](https://groups.google.com/forum/?fromgroups#!forum/android-building) 58 - Subscribe via email: [android-building](mailto:android-building+subscribe@googlegroups.com) 59 60- *android-porting*: 61 This list is for developers who want to port Android to a new device. If you're wondering how to combine the Android source code with your hardware, this is the right group for you. Discuss here the specifics of porting Android to individual devices, from obtaining toolchains and merging kernel drivers all the way to configuring or modifying applications for your specific 62configuration. 63 - Subscribe using Google Groups: [android-porting](https://groups.google.com/forum/?fromgroups#!forum/android-porting) 64 - Subscribe via email: [android-porting](mailto:android-porting+subscribe@googlegroups.com) 65 66- *android-contrib*: 67 This list is for developers who want to contribute code to Android. This is a working list, and is not appropriate for general discussion. We ask that general discussion go to android-platform. Note: contributors to the Android kernel should go to the android-kernel list, below. 68 - Subscribe using Google Groups: [android-contrib](https://groups.google.com/forum/?fromgroups#!forum/android-contrib) 69 - Subscribe via email: [android-contrib](mailto:android-contrib+subscribe@googlegroups.com) 70 71- *android-kernel*: 72 This list is for deveopers who want to contribute to the Linux kernel that Android devices use. If you've downloaded the kernel code, if you know how to compile it, if you want to write kernel code to specifically support Android, 73this is your place. This group isn't for user-space topics (see android-platform for that), and people will shake their fingers at you and call you naughty if you ask user-space questions here. 74 - Subscribe using Google Groups: [android-kernel](https://groups.google.com/forum/?fromgroups#!forum/android-kernel) 75 - Subscribe via email: [android-kernel](mailto:android-kernel+subscribe@googlegroups.com) 76 77## Using email with Google Groups ## 78 79Instead of using the [Google groups](https://groups.google.com/) site, you can use your email client of choice to participate in the mailing lists. 80 81To subscribe to a group without using the Google Groups site, use the link under "subscribe via email" in the lists above. 82 83To set up how you receive mailing list postings by email: 84 851. Sign into the group via the Google Groups site. For example, for the android-platform group you would use [https://groups.google.com/forum/?fromgroups#!forum/android-platform]. 86 871. Click "My membership" on the right side. 88 891. Under "How do you want to read this group?" select one of the email options. 90 91## Android on IRC ## 92 93We also have a presence on IRC via [freenode](http://freenode.net/). 94We maintain two official IRC channels on [irc.freenode.net](irc://irc.freenode.net/) (access via the web 95at [freenode webchat](http://webchat.freenode.net/)) 96 97- [\#android](irc://irc.freenode.net/android) - dedicated to general Android discussion and porting concerns 98 99- [\#android-dev](irc://irc.freenode.net/android-dev) - dedicated to discussion about writing Android applications 100 101The channels above are official. There are a few other channels the 102community is using, but are not official. These aren't official or officially 103moderated/managed, so you use the channels below at your own risk. The Open 104Handset Alliance doesn't endorse these channels, there's no warranty express 105or implied, and so on. There may be more channels than just these listed. 106 107- [\#android-firehose](irc://irc.freenode.net/android-firehose) - displays in real-time the commits to the Android Open Source Project 108 109- [\#android-fr](irc://irc.freenode.net/android-fr) - pour discuter d'Android en français 110 111- [\#android-offtopic](irc://irc.freenode.net/android-offtopic) - for, well, off-topic discussions 112 113- [\#android-root](irc://irc.freenode.net/android-root) - for discussion related to off-label uses of hardware 114
