-
Notifications
You must be signed in to change notification settings - Fork 76
How to Contribute
- Getting the source code
- How to work with Wok submodules
- Submitting changes
- git-sendemail configuration
- Commit changes locally
- Create the patch files
- Send patch to the mailing list
- Getting your contribution accepted
Wok Project uses Git for source versioning/controlling/management, and its remote and official repository is hosted GitHub. To clone the source code into your local repository, you only need to execute this command:
$ git clone https://github.com/kimchi-project/wok.git
To get the latest updates you only need to execute:
$ git pull
Need documentation about how to use Git? See this documentation.
All patches are sent through our development mailing list hosted at oVirt Project. More information can be found at:
http://lists.ovirt.org/mailman/listinfo/kimchi-devel
Make sure to subscribe to mailing list prior to send patches. Otherwise, your patches will not be delivered.
Patches should be sent using git-send-email (use your Linux distribution package manager to get it). A good point of start is described in the steps bellow:
Add into .git/config file the following content (modify the content between <greater-than and less-than signs> with your personal information):
[alias]
makepatch = format-patch --subject-prefix=\"PATCH] [Wok\" --cover-letter
askreview = send-email --no-signed-off-cc --smtp-server <your SMTP server> --from \"<your email address>\" --thread --annotate
[sendemail]
to = Kimchi Devel <[email protected]>
cc = Aline Manera <[email protected]>
suppresscc = all
assume8bitEncoding = UTF-8
This content is setting up two new Git aliases into your local repository configuration: makepatch and askreview. The first alias should be used to create patch files to be sent to community review (details how to use in subsection 3). The second alias should be used to send the patch to development mailing list (details how to use in subsection 4). In addition, the section [sendemail] sets up the addresses and arguments to be used by the askreview alias.
$ git commit -s <files_modified>
While writing the commit message, add the issue number in the first line if you are fixing some issue as described below:
Issue #<number>: <issue_label>
<message describing the bug fix>
$ git makepatch origin/master
The origin/master branch can be changed to any other branch you want to use as base to create your patch.
$ git askreview *.patch
The *.patch can be changed to a specific patch file, or a list of patches, like:
$ git askreview 0001-Configure-to-ignore-changes-in-Wok-submodules.patch