Assembla FAQ and Documentation

You can connect your Assembla workspace to an external SVN repository and relate your code commits with Assembla tickets via your commit comments:

Add the External SVN tool to your workspace from the Admin-Tools page and configure it.

Install a post-commit hook in your subversion repository (all the popular subversion repositories have this feature). This post-commit hook will inform our servers when a changeset has been committed and our servers will parse the comment and relate it to the proper ticket.

If you go to your External Subversion tab, you will find at the bottom two scripts we have created in Perl and in Ruby to do this.

1. Download either of those scripts
2. Open it with a text editor and replace tool_id and secret_key with the values provided in that same tab
3. Install the post-commit hook in your subversion repository according to your software instructions

You can use the same commit comments in the External SVN tool that you can use in Assembla's repositories to link to Assembla Tickets:

Use "re #4" to link your commit to ticket number 4. "references", "refs" and "see" will add a comment to the target ticket. Use "closes #4" to close ticket 4. "closed", "close", "fix", "fixed", and "fixes" will also close a ticket. Use "test #4" to move a ticket to "ready for test" status. To enter a time record in the Time tool, use "Time: 2h15m"

.