...
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Requirement types fulfil 3 needs:
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 use Requirement Types?
In view mode
We only display invalid requirements from requirement properties, not optional properties.
...
In the Confluence editor
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.
...
...
We only display invalid requirements from requirement properties, not optional properties.
...
Inserting a requirement type as a template
...
If requirements are already inserted, then “Quick Fix” will also update the table dynamically:
...
...
How to configure requirement types?
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.
...
Editing requirement types
Properties are described as a horizontal table, so it looks like the final page.
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.
Validations on requirements
Validations are what will let you know if your requirements comply to their type or not.
Running the validations
Validations can only be run in two ways:
...
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.
Permissions
People who can view the space can list the key suggestions, requirement types and their properties.
...
Space-admins can create, update and delete requirement types, and lock down the keys.
Limitations
We have limits for the number of validation messages generated by page. Currently, the limit is 200 SQL requests per run, 1000 messages and 5 seconds, and the limit of requirement types that can apply to a single page is 20.