> For the complete documentation index, see [llms.txt](https://docs.dataloy.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dataloy.com/release-8.29-coming-soon/voyage-management-system/step-by-step-guides/comments.md).
# Comments
All modules have their own comment section that can be accessed from the new sidebar in the drawers. Comments are visible to everyone who has access to a module and allows you to communicate effectively with other users of the system.
Click on the comment icon in the sidebar to open the comments panel, and use the close icon or the comment icon to collapse the panel again.
You may edit or delete your own comments at any time.
You may now mention users on a comment. The mentioned user will receive a notification once the comment is posted. You may also mention users when you edit your own comments.
You may also tag comments using the '#' symbol, to make them easier to find and filter later, and jump directly back to the drawer a comment originated from.
Collapsable comment tab on the Voyage drawer
## Adding Comments
1. Find the text field at the bottom of the comment section and type your comment.
2. Press the `Enter` key or the **Send** button to post.
Pressing `Shift + Enter` in the comment field creates a new line without posting.
## Editing Comments
*This functionality can only be accessed by comment authors.*
1. Find the menu buttonon the right side of your comment.
2. Press the **Edit** option. An editable text field appears in place of the comment.
3. Edit the text and press **Update** to save your changes.
## Deleting Comments
*This functionality can only be accessed by comment authors and administrators.*
1. Find the menu buttonon the right side of your comment.
2. Press the **Delete** option.
3. Press **Confirm** when the delete dialog appears.
## Mentioning Users
1. In the text field, press the`@` key.
2. Type the user name or user code of the user.
3. Press the `Enter` key to choose the user you want to mention.
4. Repeat the steps if you want to mention multiple users.
You may also scroll through the list of users upon pressing the `@` key. Click on the name of the user you want to mention.
When you are mentioned in a comment, a notification will show up on your bell. The notification message contains the URL of where you have been mentioned.
## Tagging Comments
Tags help you and other users find related comments quickly, such as grouping all comments relevant to a P\&L discussion. Tags are pre-loaded by your administrator.
1. In the text field, press the `#` key.
2. Type a tag name you are looking for, such as `P&L`, or select one of your organization's custom tags from the drop-down list.
3. Press the `Enter` key to add the tag to your comment.
4. Repeat the steps if you want to add multiple tags.
Tags are shown alongside the comment, so other users can immediately see how it's been categorized. Tags can be added anywhere in your sentence.
## Filtering Comments
Comments are shown from newest to oldest as a default.
1. Open the comment section of a drawer.
2. Use the filter option above the comment list to filter by tag, such as `#P&L`.
3. You may also filter by workflow context to narrow the list down to comments created from a specific area of the module, such as `Voyage`.
4. Clear the filter to return to the full comment list.
5. Use the sort toggle to show oldest to newest.
## Navigating to a Comment's Origin
Every comment displays where it was created, so you can see the context behind operational and financial discussions at a glance.
1. Locate the origin label shown with the comment.
2. Click the label to navigate directly to the related Voyage, Cargo, Port Call, or other drawer the comment came from.
This is especially useful when reviewing comments from a different drawer than the one they originated in, such as a Voyage-level comment that references a specific Cargo.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.dataloy.com/release-8.29-coming-soon/voyage-management-system/step-by-step-guides/comments.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.