Developer Notes

---

• Source Code Repository
• Development Work Flow
  • Issue Tracker
  • Repository

---

Source Code Repository

This project uses Git, a distributed version control system, to track changes to its files. You will need to download it from http://git-scm.com.

After Git is installed, type the following on the command line to retrieve the source code.

:::bash
$ git clone git://git.code.sf.net/p/jahm/code jahm-code

You should now have a copy of the project's files in a folder named 'jahm-code'.

Development Work Flow

All changes originate from a ticket created in the issue tracker. An appropriate branch is created in the repository from the ticket. Updates are then made and committed to the branch. When updates are complete, the branch is terminated and the ticket is closed.

Issue Tracker

Ticket Type |
------------- | -------------
defect | undesirable program behavior, coding practice, or documentation
task | desirable change (to code or documentation) not due to a "defect"
build | release preparation activity

Repository

Branches progress following the GitFlow model.
For descriptions of this model see posts on nvie.com and atlassian.com.

Branch Type |
------------- | -------------
master | tagged official releases
develop | most recent activity
feature | targeted change to the 'develop' branch, initiated by the tracker
hotfix | critical defect correction to the 'master' branch
release | preparatory activity for official release