Refactor Kanvas documentation: remove outdated sharing resource section and enhance commenting instructions

leecalcote · leecalcote · commit 9a6a93d838e1 · 2025-04-24T16:34:24.000-05:00
Signed-off-by: Lee Calcote &lt;lee.calcote@layer5.io&gt;
diff --git a/content/en/kanvas/designer/comments/index.md b/content/en/kanvas/designer/comments/index.md
@@ -10,8 +10,6 @@ aliases:
   - /meshmap/designer/comments
 ---
 
-## Overview
-
 Kanvas'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 historical record for reference later.
 
 <figure style="width:400px;">
@@ -21,11 +19,12 @@ Kanvas's Designer offers enables you to place comments "inline" with your infras
 
 ## Commenting on a Design
 
-You can add comments in a number of convenient ways.
+You can add comments in a number of convenient ways. Since designs are public by default, you can add comments to your designs without having to share them first. This is particularly useful for gathering feedback from team members or stakeholders before finalizing the design.
 
 ### Commenting via the Dock
 
-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 design.
+1. 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 design or first identifying where you want to place your comment.
+2. You can also create a comment by dragging and dropping the comment icon from the Dock to your design. This method allows you to place comments directly on specific elements or areas of your design.
 
 <figure style="width:400px;">
 <img src="./comment-dock.png" alt="Create a comment from the Dock" />
@@ -41,10 +40,6 @@ Context-click on any area of your design, and from the contextual menu, select "
   <figcaption>Comment by context-clicking on your design</figcaption>
 </figure>
 
-### Commenting via drag-and-drop from the Dock
-
-Add comments to your design by clicking and dragging a new comment from your dock to any area of your design. If you don't see a dock, ensure that the dock feature is enabled. To toggle visibility of the dock, context-click anywhere on the canvas, choose Options and enable the Dock feature.
-
 ### Commenting via hotkey
 
 <button class="kbc-button kbc-button-xs">⌘/CTL + M</button> Add a comment into your design when you press this hotkey combination. After pressing the hotkey, a new comment will be displayed. You can move the new comment anywhere in your design.
diff --git a/content/en/kanvas/designer/sharing/index.md b/content/en/kanvas/designer/sharing/index.md
@@ -7,14 +7,17 @@ categories: [Designer]
 tags: [designs, collaboration, review]
 aliases:
   - /meshmap/designer/share-resource
+  - /kanvas/designer/share-resource
 ---
 
 ## Overview
 
 In Kanvas, you can share your designs or designs for which you have permission to share with other members of your organization and teams, and you can control access permissions. This page describes the different access types for designs and how to effectively use them.
 
 {{< alert title="Note">}}
+
 - You can share and use control access to manage views permissions and visibility also with same methods.
+ 
 {{< /alert >}}
 
 ## Visibility
