= Contributing Code =
* Join the [https://sourceforge.net/mailarchive/forum.php?forum_name=amahi-devel amahi-devel list]* If it's your first time, grab a copy of the git repo git clone git://git.amahi.org/amahi.git * If not, pull any changes from the master repo cd amahi (the root of the git tree) git pull * Get yourself familiar with the pieces, and ask questions!* Make some changes to the code, then test them:* e.g. for testing the platform: cd platform/platform/html ./script/server and access it at http://hda:3000 * You can see your changes with two git tools: status and diff git status * The status gives you a list of what files were modified, added or removed. you can see changes in your area with: git diff --cached * When you know you want to modify a file, you add it to the changes to be committed, for example, say a README file: git add README * For the parts that are added and checked in, you can see the changes with git diff * This is what will be committed! * Then actually commit your changes to your git repo: git commit * After that you can generate a patch to be sent upstream, e.g. for a patch of the latest commit.: 1. Go into the patch folder located in the root of the git tree. 2. git format-patch HEAD^..HEAD NOTE: When creating the patch title(first line) please put it in YYMMDD-PATCHSEQUENCE#-long-patch-name.patch format. In the long name please include what module you are working on. AKA what application etc.. * This will generate a file called 0001-my-patch.mbox or similar (type ls -l 00*), which then you can email or pastebin it to someone to be committed upstream. You probably want Follow this page to [[Configure Git]] to your liking first to display the email properly. * Please note, once the patch is applied upstream, your name and email WILL be officially in the [http://git.amahi.org amahi git repoContribute code] as as contributor, which mean it's in the open and it's crawlable, so please use your PUBLIC name/email accordingly. * For more details, ask in the [http://forums.amahi.org forums], [https://sourceforge.net/mailarchive/forum.php?forum_name=amahi-devel amahi-devel list], or come by the [http://talk.amahi.org IRC channel]
