Team work often involves discussion on particular keys therefore you can take advantage of the comments widget.
Opening a comments widget
To leave a comment for a key, proceed to the project editor and click on the corresponding button under the key name:
Once this button is clicked, you'll be presented with a comments widget (previously known as a "chat widget"):
In this widget you'll see the key name you are leaving comment for (
welcome in this case). You will always see unread comments at the top of your comments panel.
You can also open this widget by pressing
Cmd+Shift+M) key combination or by clicking the Comments button in the left menu:
Writing a message and notifying other contributors
Type your message in the text box and then press
Enter. You can mention other contributors by entering
@ character and then typing their name. Please note that the message length is limited to 1000 characters.
Once you leave a comment on the key, it is automatically emailed to everyone mentioned with the
@ symbol. You can control your notification settings in the personal profile.
Editing and deleting messages
You can edit and delete your comments by clicking on three smal dots next to your message:
Navigating the widget
You can click on the "arrow with a circle" icon to jump to a translation key that this comment was left for. The key in question will be highlighted with yellow:
You can also return to all comments for the given project by clicking on the "left arrow" icon at the top:
Finally, you can switch between projects in the comments widget by clicking on the projects dropdown (when you've returned to the list of all project comments):
You can mark all comments as read by clicking on the cog icon and choosing the corresponding option:
Please note that if you are browsing the list of all project comments, you won't be able to write a new comment. In other words, you cannot leave generic comments not linked to any key or translation. To write a comment, please proceed to a specific key/translation:
Comments support threading. To start a thread, click Reply in thread:
You'll see a very similar interface:
The thread can be resolved (closed) by clicking on the checkmark icon in the top right corner.
You can also resolve a thread when viewing all key comments:
If a thread is resolved, it won't be shown in the list by default. However, you can open all comments list and click on the fliter icon to view resolved threads:
Please note that the key comments are no longer saved in the project snapshots and therefore cannot be restored from a snapshot.
In other words, if a comment is deleted, there's no way to restore it.
Comments will not be merged when merging branches. In other words, if you are merging
branch_a, comments from
branch_bwill be lost and only comments from
branch_awill be preserved.
Comments must be linked to a key or translation: you cannot write generic comments like in ordinary chats.