Polish SpreadJS comments docs

Author: yoen-velt

async-collaboration/comments/setup/spreadjs.mdx

@@ -1,8 +1,9 @@
 ---
 title: "SpreadJS Setup"
+description: "Add Velt comments to a SpreadJS workbook with the Velt SpreadJS comments extension."
 ---
 
-![](/gifs/Add-Text-Comments.gif)
+![Add text comments in a spreadsheet](/gifs/Add-Text-Comments.gif)
 
 The SpreadJS integration renders each Velt comment as a view-only overlay positioned over the commented cell or range. It does not modify your workbook. Comment anchors are stored as durable `{ sheetName, row, col, rowCount, colCount }` data and re-resolved to pixels with SpreadJS cell geometry whenever comments render.
 
@@ -62,7 +63,7 @@ npm i @veltdev/spreadjs-velt-comments @mescius/spread-sheets @mescius/spread-she
   </Tab>
 </Tabs>
 
-#### Step 3: Configure a SpreadJS workbook with Velt Comments
+#### Step 3: Configure the SpreadJS workbook with the Velt Comments extension
 
 Create the workbook, import your spreadsheet, then attach `SpreadJSVeltComments` after the import completes. The same workbook instance is used by `addComment` and `renderComments`.
 
@@ -143,9 +144,9 @@ Create the workbook, import your spreadsheet, then attach `SpreadJSVeltComments`
   </Tab>
 </Tabs>
 
-#### Step 4: Add a comment button or selection bubble
+#### Step 4: Add a comment button to your SpreadJS workbook
 
-SpreadJS renders the grid to a canvas, so there is no DOM text selection for a default text bubble menu. Use the workbook's selected cell/range state to show your own button or contextual bubble, then call `addComment({ instance })`.
+SpreadJS renders the grid to a canvas, so there is no DOM text selection for a default text bubble menu. Add a toolbar button or contextual selection bubble that uses the workbook's selected cell/range state, then call `addComment({ instance })`.
 
 <Tabs>
   <Tab title="React / Next.js">
@@ -189,7 +190,7 @@ To scope comments to a specific workbook on pages with multiple SpreadJS instanc
 SpreadJSVeltComments.configure({ editorId: 'EDITOR_ID' }).attach(workbook);
 ```
 
-#### Step 6: Render comments in the workbook
+#### Step 6: Render comments in SpreadJS workbook
 
 - Get comment data from the Velt SDK and render it in the SpreadJS workbook.
 - Params: [`RenderCommentsArgs`](/api-reference/sdk/models/data-models#spreadjs-rendercommentsargs). It has the following properties:
@@ -231,7 +232,7 @@ return () => {
 };
 ```
 
-#### Step 8: Style the commented cells
+#### Step 8: Style the commented text
 
 - Each comment is rendered through a `.velt-spreadjs-overlay` layer with a `.velt-spreadjs-highlight` range fill and a `velt-comment-text` marker.
 - Override the default inline highlight styles with `!important`.