...
| In the popup |  |
|---|---|
| In any popup that references to this requirement |  |
| In other requirements (in which case they're called dependencies) |  |
| In the search |  |
| In JIRA |  |
Do's and Don't
| Do | Don't |
|---|---|
| Write relatively short titles for your requirements, then add details in other columns. | Don't write a full document inside a requirement. It is not useful for a user to display "everything" in JIRA, especially since it is not designed for it. Confluence is much better at displaying content. |
| Use a table to structure your requirements, link one requirement per row. | Better not try to define a full paragraph or section of a document as a requirement. |
| Use short requirement keys with a prefix. Example: "FUNCTIONAL-001" or "FN-001". | Use spaces or expressions as requirement keys. Only letters, numbers, underscore (_), hyphen (-) and dot (.) are accepted. Don't use the view mode's "inline creation" if you're starting. That only becomes useful when you're tired of importing requirements from Word. |
Tips
- You can use the shortcut (Alt + Shift + R) on a full table, and Requirement Yogi will add one key per row.
- You can paste an entire Word document, then save, then use the inline creation to switch all sets of letters to requirements.
| Info | ||
|---|---|---|
| ||
Everything else is tools around the Requirement macro. Get going with your job!
But keep it simple, start with writing requirements! |
...