Updating 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.

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.

Most card keywords would have been created during initial project setup, but you may want to update card keywords if you find team members are using terms to describe cards that are not being converted to links. This may happen if you change a card property, e.g. if you change a card from Type = Defect to Type = Bug, you may want to add a new card keyword called 'bug'.

How to create and update card keywords

Sign in to Mingle as a project administrator and open the project you want to change (if you're not already working in the project).
Click the Project admin tab.

Mingle displays the Project settings page.

if you are logged in as a project team member, Mingle displays the Team page.
Click the Card keywords link.

Mingle displays the Card keywords page.
Type the keywords you would like Mingle to recognize and convert to links. Separate your keywords with a comma and a space.

In the above example, if you want to link to card 123, you can type
```
#123
```
,
```
story 123
```
,
```
card 123
```
,
```
defect 123
```
,
```
bug 123
```
,
```
fixed 123
```
or
```
fix 123
```
and Mingle will automatically create a hyperlink to this card.
If you have integrated your source repository with Mingle, you may wish to check whether your card keywords pick up card numbers in existing commit messages (see below).
Click the Update keywords link.

Testing card keywords source control integration

Before you begin, you must know the number of a card that has been referenced in a source commit message, e.g. Fixed bug 123.

Sign in to Mingle as a project administrator and open the project you want to change (if you're not already working in the project).
Click the Project admin tab.

Mingle displays the Project settings page.

if you are logged in as a project team member, Mingle displays the Team page.
Click the Card keywords link.

Mingle displays the Card keywords page.
Type the number of a card that you know has been referenced in a subversion commit message.
Click the Show last 10 matching revisions button.

Mingle displays all matching subversion revisions. If you get results returned, this means you've selected good card keywords and Mingle is picking them up in commit messages.

If you don't see any matches, or not as many as you would expect, try adding different keywords and repeating.
Don't forget to click the Update keywords link to save your card keywords if you haven't done so already.

Help