Updating Issues
The main section of the screen contains the discussion on the issue. To save space on the screen, there is a Membership Setting accessible via Project > Settings that lets the user determine how many comments to display on an issue. If all comments are not displayed, clicking Load remaining # comments will display all of the comments.
If history is recorded for fields and changes have been made to those fields, the information on what was changed will be displayed in the comment boxes. If things were changed for an issue, but no comment was made, the changes are listed without a comment.
You can preview how a comment will look by clicking the Preview tab at the top left of the Comments box. This will allow you to make sure that you used the formatting tags correctly. Click the Write tab to return to edit mode.
To update an issue without leaving the page, hold the Shift keyboard key, then the Update Issue button will become the Save Issue button. Click Save Issue and your updates will be saved without leaving the issue. If you close the browser tab or your session expires while a comment is being drafted, then Squish will remember it and display the text in the comment box for that issue if you are using the same browser. Clearing the browser’s cache will remove any comments being remembered this way.
Making Changes to Existing Comments
Individual comments can be manipulated in several ways. Clicking the timestamp link for an issue will update the page URL to specifically reference the corresponding comment. That comment will be displayed as close to the top of the screen as possible when using that link to view the page.
Several options are available under a comment's menu.
- Delete - You can delete your comment if it is the last one in the list. Click the Delete link to delete a comment. Click Delete to confirm your action. If you change your mind, you can cancel by clicking Back to Issue. Once you have updated the issue, the comment is permanently removed. If you have a role that has Manager permissions, you can delete the last comment entered no matter who entered it.
- Edit - You can only edit the comments that you entered. To edit a comment, click the Edit link. When editing a comment, you have the ability to remove and add attachments. To remove attachments, click the X next to the attachment(s) you want to remove. Click Update Issue when all changes have been made. If you change your mind, you can cancel by clicking Back to Issue. Once you have updated the issue, the changes are permanent. Updated comments have a link noting the number of times the comment has been updated. This link opens a dialog displaying a printable history of changes made to the comment. If you close the browser tab or your session expires while a comment is being edited, then Squish will remember it and display the text the next time you edit that comment if you are using the same browser. If you have a role that has Manager permissions, you can edit all comments.
- Quote - You can quote a previous comment in an issue by clicking the Quote link. The full comment will be inserted in the Post a Comment field with the [quote author= ] [/quote] formatting tags. You can remove parts of the quote manually if you do not want to include it in its entirety.
- Pin - A comment can be pinned via the Pin option. This will ensure the comment is always visible to users viewing the issue, even if comments are collapsed.
- Copy link - The Copy Link option will copy a direct link to the selected comment. Navigating to this link will open the issue and automatically scroll to the comment.
Reacting to Comments
Emoji reactions can be left on existing comments from the emoji menu or by clicking an existing reaction to the comment. Each user can react to each comment with any or all of the following emojis: Like, Dislike, Happy, Sad, Surprised, Celebrate, and Love.
When you react to a comment, the commenter may receive a notification email. Notification settings for emojis can be controlled for all projects from the My Account page or for individual projects from the Membership Settings page.
Changing Confidentiality of Comments
Comments that are marked as confidential will have a lock icon next to them. If a user cannot view confidential comments, the entire comment, including the lock icon, will not be visible.
If you edit a confidential comment, you can click the Keep this comment confidential checkbox to uncheck it. Click the Save Changes button to save the change to the comment.
Resolving issues
When submitting a new comment, or editing an existing comment, the Mark this comment as the resolution for the issue checkbox is available. Selecting this will highlight the comment in the issue and add a "Resolution" tag to the comment next to the date/time. The text of that comment will be the Resolution field’s value in searches.