Working with Requirements

You can view a requirement specification or a requirement and create comments, annotations, and other markers on its content.

Before you begin: Open a requirement specification or a requirement.
Note: You can have only one requirement specification or one requirement as a context for a markup.
  1. From the Markup section of the action bar, click Markup .
    A markup is created for the requirement specification or the requirement loaded in the widget.
  2. Click Comment to add a comment.

    • You can also create a comment by clicking + in the comments panel or using commands available in the context toolbar.
    • You can create comments linked to the selected text, marker, or a selected point or position of the requirement specification.

    The comment is displayed in the comments panel. If the comment is linked to the text, it is highlighted in the color assigned to the creator of the comment.
    Notes:
    • When you delete a comment, you can also choose to delete the markers associated with it by selecting the Delete markers associated with selected commands in the message box.
    • You can manually save the markup, whenever you edit a comment. To do so, click the spinner in the upper-right corner of the work area.
    • When the widget width is smaller than 550 pixels, the panel is automatically hidden in the following cases:
      • After selecting a comment in the comments panel
      • While adding a new comment using New Comment +
      • After validating the comment
      • While activating or deactivating the markup
  3. Create freehand, circle, rectangle, and arrow markers to highlight parts of the requirement specification.

    Notes:
    • You can edit and move these markers using the transformation handles.
    • You can create markers only within the boundaries of the page.
    • You can manually save the markup whenever you edit the graphic properties or the position of the marker. To do so, click the spinner in the upper-right corner of the work area.

  4. Click one of the following commands to browse through the comments in the requirement specification:
    • Previous Comment : Navigates you to the previous comment in the comments panel.
    • Next Comment : Navigates you to the next comment in the comments panel.
    • < and > options in the comments panel to navigate to the previous and the next comment respectively.

    Notes:
    • The comments panel is not visible in the presentation mode.
    • If the comment is created on a missing requirement element, a warning icon is displayed next to the comment, in the comments panel.

  5. From the View section of the action bar, click one of the following commands to move to a previous or the next page:
    • Previous Page : to display the previous requirement.
    • Next Page : to display the next requirement.
  6. Optional: Click the hyperlink on the page to open it.
    • If the hyperlink points to an external URL, it opens in a new tab.
    • If the hyperlink points to a position in the context, the pointed position is displayed.
  7. Optional: Click Bookmarks Panel .
    A panel displaying all the chapters, sub-chapters, requirements under the requirement specification, and comments on the requirements in a tree structure. Click to see all the sub-elements.

    The Bookmarks Panel command is only available for requirement specifications.

    Note: By default, The bookmark panel is displayed.

    Note: When the widget width is smaller than 550 pixels, the panel is automatically hidden when you activate a bookmark in the Bookmarks Panel.
  8. Optional: Click Presentation Mode .
    The presentation mode lets you browse through the comments and elements in the loaded requirement or requirement specification.
    Note: When you hover over any text or markup element associated with a comment, the comment is displayed.