Reviewing Designs

Learn how to leverage comments in MeshMap’s Designer Mode to enhance collaboration and streamline design reviews.

Overview

MeshMap’s Designer offers enables you to place comments “inline” with your infrastructure as code. Use comments to offer feedback to team members, take detailed design notes, capture helpful tips for your team members, and include justification as to your infrastructure and application configuration decisions. Pay it forward to your future self by leaving comments for reference later.

Three Ways to Add Comments

You can add comments in three convenient ways:

Commenting via the Activity Toolbar

Click on the comment icon in the toolbar to open a comment instantly. This is your go-to method for quick annotations without leaving your canvas.

Comment through toolbar (1)

Commenting via Context-Click in Canvas

Right-click on any area of your canvas, and from the contextual menu, select “Comment” or use the shortcut Ctrl + M (Command + M for Mac users). This allows for swift comment placement right where you need it.

Comment by right-clicking

Commenting via drag-and-drop from the Dock

To access comment from whiteboarding doc make sure your whiteboarding feature is enabled, select comment tool from doc and drop it anywhere on canvas to comment.

Tips for using Comments as a Design Review Tool

Design review inside comments in designer

Initiate Threads

You can initiate a comment thread by just adding a comment. Your comment may be a request for design review or feedback on a design. Team members can reply directly to comments to for a comment thread. This creates a structured dialogue around each point of feedback for easy referencing.

Utilize Mentions

Easily draw the attention of relevant team members by tagging them in your comment. To activate this, type @ in the comment box and a list of your team members will appear then you can select who you want to mention. This ensures that the right people are notified and can contribute to the discussion.

Comment on Specific Elements

Leave comments on specific elements within the design, whether it’s a shape, text, or an entire component. This specificity ensures that feedback is targeted and directly related to the part of the design under discussion.

Avoid Dangling Threads / Resolving Comment

Once revisions are complete, you can resolve the comment. This action closes the comment thread and signifies that the conversation around that feedback has concluded.

View Comment History

After resolving a comment thread, you can access the comment history to review previous discussions and decisions.

Conversation inside comments in designer

Enable Email Notifications

Customize your notification preferences to receive emails for comments on your design. When this is enabled, you’ll be notified when comments are made on your design, you’re mentioned in a comment, or someone adds a comment to a thread you’ve previously engaged with.

Unresolving Comments

After a comment has been resolved, there might be situations where you need to reopen the discussion. Unresolving a comment allows you to reinitiate conversations, address additional concerns, or make further changes. Follow the steps below to unresolve a comment:

Unresolving comments in designer

Best Practices for Effective Design Reviews

Be specific and actionable

Provide specific feedback rather that the design can act on. Vague comments can lead to misunderstandings and delays in the design process. Support your feedback with examples or references. This can help clarify your point and provide the designer with tangible suggestions for improvement.

Balance positive and contructive feedback

Frame feedback in a constructive manner, focusing on how things can be improved rather than just pointing out flaws. Acknowledge what works well in the design before delving into areas that need improvement. This helps maintain a positive and collaborative atmosphere.

Regularly check and respond to comments

Stay engaged in the review process. Regularly check and respond to comments to keep the conversation alive and ensure a smooth workflow.

Prioritize feedback

Highlight the most critical feedback first. This ensures that the designer focuses on the most important aspects for improvement.

Last modified February 18, 2024: Fixing typos (b3d5ddb)