When working in a requirement model, you sometimes want to add a remark or pose a question. In this entry we will explain how to use the comments feature for that purpose.
Making comments can be done in the comments table that can be found at the top of each detail view. You can add comments by clicking on the Add comment button.
When placing a comment, you can assign a comment to a specific person by clicking on Addressee. A drop-down pick-list will open up showing you all the registered users with access to this model. Pick the one that you want to pose this question or comment to.
Replying to comments
To respond on a comment, you have to click on the icon, after which you can type in your reply.
If the person who has created the comment is satisfied with the assignee’s answer (or if it has been solved in another way), the comment can be put on processed.
Comments that are processed can still be found in the comments overview, but they not shown on the detail views anymore (unless you change the default filter setting for the comments table, by clicking on the x icon).
The alternative is to delete the comment (by clicking on the icon). Please note that when deleting a comment, they are really gone.
Comments assigned to you
Comments that are assigned to you (and not yet processed) can be found at the bottom of the project homepage, which is the page that you get to see when accessing the model.
From there, you can jump to the comment overview (see below), or to the detail views of the objects where the comments have been made, where you can then deal with them.
An overview of all the comments in the model can be found under overviews in the navigation bar.
In the overview, you can the various filters (in the column headers) to find what you are looking for.
This overview is often used in project team meetings to review and address issues that still have to be done.
Including or excluding comments
As explained in the beginning, the comments feature is often used for internal communication. Think of a project manager asking questions to one of his or her team members about a particular requirement.
This is typically not the kind of information that you want to include in the published versions of your model. The default setting therefore is that comments are not included when publishing. It is, however, possible to include comments by using the check box.