Usage with Git and Subversion

Source control system is an absolute necessity in modern software development. Depending on the type of project you might want to use either Git or Subversion. Agile Toolkit uses Git due to its open-source nature. If you are willing to add changes to Agile Toolkit, you can fork it on GitHub.com.

Git Introduction

If you want to use the most up-to-date copy of Agile Toolkit, then you will need to use "git". Git is a command-line interface utility, which is executed as "git command arguments ..'. A good starting guide on Git is: http://book.git-scm.com.

https://github.com/atk4/atk4 is the GitHub page for Agile Toolkit. You will find a "branch" switch as well as a selection of tags. There are two major branches: "devel" and "master". All the stable releases are based on the "master" branch, while beta releases are based on the "devel" branch. Sometimes new feature branches will appear, as experimental features are being developed.

The documentation on this site applies to the 4.1 branch (or later, where specified). As the code in the project is improved, some functions might be renamed. Backwards compatibility is maintained throughout one major upgrade release, for instance: migrating 4.0 code to 4.1 probably works well and requires little change, but migrating from 4.0 to 4.2 might require you to change several calls to functions which have been made obsolete. Some older classes may be removed and placed under the "atk4-obsolete" repository. If your legacy code still relies on them, copy them into your local lib directory or, use the addLocation() method.

Essential Repositories