Setting up the subversion repository

Mingle can easily integrate with your team's subversion repository to link your code to bugs and requirements. By typing card numbers in the subversion commit messages, Mingle automatically links code revisions with the cards that are referenced. All code revisions are also linked to Mingle's History tab, so you can always see what code changes happened relative to other changes in the project.

Note: Your subversion repository must be on the local file system (relative to Mingle's installation). This is because Mingle's SVN integration feature is read-only. For remote SVN repositories, you can set up an NFS mount, or setup an 'rsync' script to keep an up-to-date copy of the repository on the local file system.

Mingle's Source tab lets you browse your entire SVN directory and shows:

• code revision numbers against each directory and file
• commit messages (including links to cards if card numbers were entered in the commit message)
• when the source file(s) were committed
• the name of the person who committed the source file(s) (you must set up your SVN name in your user profile).

Hint: Mingle's SVN integration is a great way to help new team members easily discover the code used to implement business features.

Mingle automatically scans all files in your SVN repository (based on the local directory path specified under Project admin > Project settings), and displays all revisions on the History tab. 

From the Source tab you can click on a revision number to view the source files that were changed in the revision and the actual changes against the previous version (diffs).

Hint: You can view all source revisions on the History tab. If you enter a card number in a commit message (using the correct card keywords) the messages in Mingle will contain links to those cards. Viewing a linked card's history displays the source revision number (which you can then click to view other changes for the revision).

How to configure the subversion repository

Hint: You can also set up the directory of the SVN repository when creating a new project.

1. Sign in to Mingle as a project administrator and open the project with the SVN directory you want to add or change (if you're not already working in the project).
2. Click the Project admin tab.
   
   
   
   Mingle displays the Project settings page.
   (Note: If you are logged in as a project team member, Mingle displays the Team page.)
3. Click the Show advanced options link.
   
   
   Mingle displays extra project information.
   
   
4. Type the SVN Repository path.
   This is relative to the directory where Mingle is installed.
5. Click the Save link.
   Mingle scans your source repository and adds it to your project data. You'll also see a new Source tab.
6. Click the Source tab to check to see whether or not Mingle has successfully integrated with your source files.
   If not, you may have to revise the source repository URL.

Also see...

• Linking source files to bugs and requirements
• Checking card keywords against commit messages
• Changing project settings (including the location of the SVN repository)

Back to Customizing projects