Creating card keywords

Card keywords are words, numbers or symbols that Mingle uses to create automatic links in cards and wiki pages. When you're editing a card or wiki page and you add any of these keywords, Mingle will automatically convert them to links.

Example: Your project has a card keyword definition of '#'. You're editing the description for a card and want to create a link to card number 123. Type #123 in the description to create a hyperlink to card 123.

Choose card keywords based on the terminology that your team uses to describe cards, e.g. bug, defect, story, requirement, task, risk. At a minimum, it's a good idea to include card keywords that match the card types you create in card properties.

When you type card keywords in Mingle (e.g. when editing a card description), always type the keyword followed by the card number, e.g. #123 or card 123. It's irrelevant whether or not you add a space.

If in doubt, it's better to include more card keywords than you'll probably use.

How to create and update card keywords

Using card keywords in subversion messages

One of Mingle's strengths is the ability to link subversion commit messages to specific cards. This means you can link source versions to a bug, story or user requirement.

Using the example in the procedure above, if you type #123 in a commit message, Mingle automatically creates a link to card number 123. When you're editing card number 123, you'll also see the source version and commit message in the card's History tab.

In the History tab for Card 1 above, you can see that Revision 937 addressed some aspect of this card (story 1). Clicking the Revision 937 link would take you to the Source tab where you could see all source files changed for that revision.

To use this feature, you must have successfully integrated your subversion repository with Mingle.

 

How to check whether your card keywords pick up card numbers in existing commit messages

Back to Creating project properties