Collaborating in Real Time through the Comments Panel in Altium Designer
Summary
The Comments panel allows you to add comments to a defined area or point in the active document of a managed project. The panel allows all users who are working on the document to add comments and view all comments without actually modifying the document itself. This feature allows facilitation of strong collaboration processes and is invaluable when issues within the document need to be pointed out without receiving conflicts. The Comments panel essentially can be used to create a 'to do' list and as the design matures. the comments can be resolved and closed.
Panel Access
The panel is accessed from a managed project by performing one of the following then clicking in the document to define the point or area for the comment:
- Click Place » Comment for Area from the main menus.
- Click Place » Comment for Point from the main menus.
- Click Place » Comment from the main menus.
- Right-click and select Place » Comment for Area.
- Right-click and select Place » Comment for Point.
- Right-click and select Place » Comment.
- Click the (to begin a new comment thread for an area) or (to begin new comment thread for a point) button on the standard toolbar.
Display Settings
You can configure which comments are displayed in the panel as well as specify whether or not to display the comments on the schematic or PCB by clicking Settings at the top of the panel.
Use the Settings drop-down menu to configure the display of the comments:
- Show Closed - enable to show closed comments in the panel.
- Show for Whole Project - enable to show comments in the panel for the entire project. With this option enabled, the comments are listed by document as shown in the following image. Use the down arrow to close the comments of that specific document. This is particularly helpful with a large project that has numerous documents.
- Show on Schematic - enable to display the comments on the schematic document.
- Show on PCB - enable to display the comments on the PCB document.
Working with Comments
Adding a Comment
To add a new comment, type the desired comment in the text box then click either the Post button or press Ctrl+Enter. The comment will be committed and appear in the panel as well as in the workspace and is linked to the point, area, or component by a dashed reference line.
Editing a Comment
To edit a placed comment, click the associated with the comment you want to change then enter your edits in the text box. Click Save when you are done editing.
Resolving a Comment
To resolve (close out) a comment, select the comment to highlight it, then click Resolve. The comment closes.
Opening a Comment
A placed comment can be opened by double-clicking the comment in the workspace or by clicking Reopen in the Comments panel.
Deleting a Comment
To delete a comment, click the associated with that comment.
Tips
- When a comment is added, it is seen instantly by all other users that have the same Managed Project and document open in their workspaces.
- The Comments panel will track the entire thread of a specific comment, however, only the latest comment in that thread is displayed in the workspace.
- The active/selected comment on the Comments panel is highlighted. In the workspace, that active/selected comment is distinguished by a dashed reference line.