Add instructions for using custom recipe + contributing back. closes #76

docs/source/contribute.rst

@@ -0,0 +1,48 @@
+Contribute
+==========
+
+
+Write your own recipe
+---------------------
+
+A recipe allows you to compile libraries / python extension for the mobile.
+Most of the time, the default compilation instructions doesn't work for the
+target, as ARM compiler / Android NDK introduce specifities that the library
+you want doesn't handle correctly, and you'll need to patch. Also, because the
+Android platform cannot load more than 64 dynamic library, we have a mechanism
+to bundle all of them in one to ensure you'll not hit this limitation.
+
+To test your own recipe via Buildozer, you need to:
+
+#. Fork `Python for Android <http://github.com/kivy/python-for-android>`_, and
+   clone your own version (this will allow easy contribution later)::
+
+     git clone http://github.com/YOURNAME/python-for-android
+
+#. Change your `buildozer.spec` to reference your version::
+
+     android.p4a_dir = /path/to/your/python-for-android
+
+#. Copy your recipe into `python-for-android/recipes/YOURLIB/recipe.sh`
+
+#. Rebuild.
+
+When you correctly get the compilation and your recipe works, you can ask us to
+include it in the python-for-android project, by issuing a Pull Request:
+
+#. Create a branch::
+
+     git checkout --track -b recipe-YOURLIB origin/master
+
+#. Add and commit::
+
+     git add python-for-android/recipes/YOURLIB/*
+     git commit -am 'Add support for YOURLIB`
+
+#. Push to Github
+
+     git push origin master
+
+#. Go to `http://github.com/YOURNAME/python-for-android`, and you should see
+   your new branch and a button "Pull Request" on it. Use it, write a
+   description about what you did, and Send!

docs/source/index.rst

@@ -36,6 +36,7 @@ mailing list <https://groups.google.com/forum/#!forum/kivy-users>`_.
    installation
    quickstart
    specifications
+   contribute
 
 Indices and tables
 ==================

docs/source/specifications.rst

@@ -95,7 +95,7 @@ Section [app]
   that require compilation), and that it doesn't have a recipe associated to
   Python-for-android, it will not work. We explicitely disable the compilation
   here. If you want to make it work, contribute to the Python-for-android
-  project by creating a recipe.
+  project by creating a recipe. See :doc:`contribute`
 
 - `garden_requirements`: List, Garden packages to include.