-
Notifications
You must be signed in to change notification settings - Fork 7
Development Process
The Adapto Project uses a typical distributed development process.
First, join the Sourceforge developers maillist list, Second, get a free SourceForge user id if you don't already have one, and send an email to the mailing list asking to to be a Sourceforge developer. In the email to the mailing list, incude a short introduction of yourself and your SourceForge user id. You'll get email confirmation of your developer status within a day or two, or more contact (if not, please follow up with another email).
To contribute code to Adapto, get a Github account if you don't already have one, and fork the main project egeniq/adapto to your own account. If you're actively working on something, please send a note to the mailing list so everyone can see where you fit into their plans (if it does), and you can benefit from the experience of the team (assuming there is any). Keeping some loosely coupled sense of community is better than none.
1. Login to GitHub and fork the master Adapto project to your own GitHub account.
- To fork the master Adapto project, access the egeniq/adapto project, and click the Fork button at the top of the page (just below your login name). Forking is similar to cloning, except forks can use GitHub's unique Pull-Request feature to submit changes back to the core project team.
- How you do this will depend on the protocol you want to use and on your development environment. The git protocol uses ssh keys instead of passwords, but uses a non-standard port and is generally blocked by corporate firewalls. The https protocol generally works behind corporate firewalls (unfortunately not mine though), but requires typing your GitHub login name and password each time you commit (although they can be temporarily cached). Which protocol you use is determined by the format of the source URL in the clone command.
- On Windows, I use the Git-Extensions GUI together with Paegent (and PuTTYgen) for managing my ssh keys
- This includes testing!
- Use git add/commit/commit -a to commit your changes locally
- First, fetch any changes that were committed recently to the master Adapto since you cloned locally, then use "$ git push origin master" to push your local changes to the repo in your GitHub account.
- Click the Pull Request button at the top of your Adapto fork (in your GitHub account).
8. Once your pull is approved, Ivo will merge it into the master codebase.