This guide is about contributing to the Android guides! Hopefully you are finding the Android guides helpful in your work with Android and are here because you are interested in contributing back. The best way to contribute is to either improve / update existing guides or to create your own for missing topics.
Check the issues for this repository to see what types of contributions would be most impactful. In particular, I will maintain an issue that contains the most important missing topics. Also look for items in the cliffnotes with the Needs Attention mark which indicates the guide needs some love.
If you want to contribute to these guides with local offline development, start by cloning the guides repo locally on your computer:
git clone firstname.lastname@example.org:codepath/android_guides.git cd android_guides git submodule init git submodule update cd guides git checkout master
You can see all the docs as markdown files in the
guides directory. Update your local copy periodically with the latest guides using:
git pull origin master git submodule update
After changes have been made, you can post the updated topic drafts online as outlined below.
For new guide, if you prefer to write your guide drafts online and keep them separate from this wiki, you can use the hackmd.io for collaborative markdown drafts.
Using collaborative online markdown tools, you can create new guide content. When the guide is ready to be reviewed, you can submit an issue to this repo with a link to the guide. Once the guide is ready, we can merge the guide back into the master wiki.
If you want to change the guides more easily, you can edit the wiki directly. The choice is up to your discretion but we recommend for small changes such as correcting typos that you update directly through the wiki.
The cliffnotes philosophy is all about cutting down the content keeping the guides lean and practical. In particular:
The most important thing is to save people as much time as possible. Include the maximum amount of useful code that we can in the smallest amount of space and 90% should be code in most cases. A few key principles to keep in mind: