Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Defining key patterns: As a project is gaining maturity, key patterns for requirements are established. Administrators can define which are the main keys, and even lock down the keys that can be inserted in spaces,

  • Validations: Administrators can define properties and dependencies which are required for a type of requirement.

  • Templates: When users insert such keys in an empty table, it will setup the table with all the properties, by default.

How to define key patterns

...

?

Each time you create a new requirement, the key will be entered to the key suggestions list. If you want a key suggestion to become a requirement type, simply edit the suggestion and give it a name.

...

Only space administrators can configure requirement types. Users have access to this screen in read-only mode, the only action they can perform is reset the sequences.

...

...

How to edit requirement types?

  • Properties are described as a horizontal table, so it looks like the final page.

  • (tick) Tip: The only difference between a simple “key suggestion” and a requirement type is having a name. When you add a name, it gives you access to all of the options. (See docs for Key Suggestions)

...

Validations are what will let you know if your requirements comply to their type or not, once you’ve configured it.

How to run the validations?

Validations can only be run in two ways:

...

Note that it is not possible to rerun all validations in a space.

How can I see the validations?

  • Required (red) fields are displayed in view mode,

  • Required (red) and optional fields (yellow) are displayed in edit mode,

  • The columns of required and optional properties are inserted in empty tables. They won’t be inserted once the tables have some amount of text.

  • “Quick fixes” can add more columns, and they are suggested next to red messages in the editor.

...

From the view mode

From the Confluence editor

We only display invalid requirements from requirement properties, not optional properties.

image-20250104-121849.pngImage Modified

...

We display a warning in the byline. When users click on it, invalid requirements appear as a red pill.

  • Bonus: When a table is incorrectly formatted, for example when the first row is made of gray cells but not headers, we will display it as a warning.

  • The “red pills” only appear if the user clicks on the validations, at the top of the editor.

    image-20250104-121920.pngImage Modified

Click on a requirement and click on “Quick Fix” will also update the table dynamically:

image-20250104-121930.pngImage Modified

How to use templates with Requirement Types?

...