docs(block-kit): re-sync data_table javadoc to docs + node review

Mirror the reviewed node SDK PR (slackapi/node-slack-sdk#2638):

- Correct the max row count: the model previously stated up to 100 data
  rows (101 including header); the reference documents 201 rows (200 data
  rows plus header). The 100 cap was page_size, not the row maximum. Drop
  the stale count from the javadoc rather than restate it.
- Align each field's javadoc with the data-table-block reference Fields
  table verbatim (rows, caption, page_size, row_header_column_index).
- Trim RawTextDataTableCell / RawNumberDataTableCell to the terse,
  docs-minimal descriptions (drop the invented sorting/formatting tails);
  document value and text per the docs.

Ref: https://docs.slack.dev/reference/block-kit/blocks/data-table-block

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>

Author: zimeg

slack-api-model/src/main/java/com/slack/api/model/block/DataTableBlock.java

@@ -9,14 +9,7 @@
 import java.util.List;
 
 /**
- * Displays a sortable, paginated grid of tabular data.
- *
- * <p>Each row is a list of {@link DataTableCell cells}; a cell may be a
- * {@link RawTextDataTableCell} ({@code raw_text}), {@link RawNumberDataTableCell}
- * ({@code raw_number}), or a {@link RichTextBlock} ({@code rich_text}). The first
- * row is the header row; header cells cannot use {@code rich_text}. A data table
- * supports 1-20 columns and up to 100 data rows (101 rows including the header),
- * with all rows sharing the same column count.</p>
+ * Displays rich tables that support pagination, sorting, filtering, and interactivity.
  *
  * @see <a href="https://docs.slack.dev/reference/block-kit/blocks/data-table-block">Data table block</a>
  */
@@ -29,25 +22,24 @@ public class DataTableBlock implements LayoutBlock {
     private final String type = TYPE;
 
     /**
-     * The rows of the table. Each row is a list of cells. The first row is the header row.
-     * Minimum 2 rows (header plus one data row); maximum 101 rows. Every row must contain
-     * the same number of cells (1-20).
+     * An array consisting of table rows.
      */
     @Builder.Default
     private List<List<DataTableCell>> rows = new ArrayList<>();
 
     /**
-     * Required. The caption describing the table, used as the caption of the rendered HTML element.
+     * A caption for the table; used as the value for the HTML caption element.
      */
     private String caption;
 
     /**
-     * The number of rows shown per page. Valid range 1-100; defaults to 5 when omitted.
+     * Number of rows per page. Min {@code 1}, Max {@code 100}. Defaults to {@code 5} if omitted.
      */
     private Integer pageSize;
 
     /**
-     * Zero-based index of the column that identifies each row. Defaults to 0 when omitted.
+     * The 0-based index of the column that uniquely identifies each row (the row header). This column
+     * is treated as the row's primary identifier for screen readers. Defaults to {@code 0} if omitted.
      */
     private Integer rowHeaderColumnIndex;
 

slack-api-model/src/main/java/com/slack/api/model/block/DataTableCell.java

@@ -9,8 +9,6 @@
  *   <li>{@link com.slack.api.model.block.RichTextBlock RichTextBlock} ({@code rich_text})</li>
  * </ul>
  *
- * <p>Header cells (those in the first row) cannot use the {@code rich_text} type.</p>
- *
  * @see <a href="https://docs.slack.dev/reference/block-kit/blocks/data-table-block">Data table block</a>
  */
 public interface DataTableCell {

slack-api-model/src/main/java/com/slack/api/model/block/RawNumberDataTableCell.java

@@ -6,10 +6,7 @@
 import lombok.NoArgsConstructor;
 
 /**
- * A {@code raw_number} cell within a {@link DataTableBlock}, holding a numeric value.
- * The {@code text} field carries the display representation of the value (for example a
- * formatted string) and must be at least one character long. Columns made up entirely of
- * {@code raw_number} cells are sorted numerically.
+ * A {@code raw_number} cell within a {@link DataTableBlock}: an object containing a numeric value.
  *
  * @see <a href="https://docs.slack.dev/reference/block-kit/blocks/data-table-block">Data table block</a>
  */
@@ -20,6 +17,14 @@
 public class RawNumberDataTableCell implements DataTableCell {
     public static final String TYPE = "raw_number";
     private final String type = TYPE;
+
+    /**
+     * The numeric value.
+     */
     private Double value;
+
+    /**
+     * The text used to display the value. The minimum length is 1 character.
+     */
     private String text;
 }

slack-api-model/src/main/java/com/slack/api/model/block/RawTextDataTableCell.java

@@ -6,8 +6,7 @@
 import lombok.NoArgsConstructor;
 
 /**
- * A {@code raw_text} cell within a {@link DataTableBlock}, holding unformatted plain text.
- * The {@code text} must be at least one character long.
+ * A {@code raw_text} cell within a {@link DataTableBlock}: an object containing some text.
  *
  * @see <a href="https://docs.slack.dev/reference/block-kit/blocks/data-table-block">Data table block</a>
  */
@@ -18,5 +17,9 @@
 public class RawTextDataTableCell implements DataTableCell {
     public static final String TYPE = "raw_text";
     private final String type = TYPE;
+
+    /**
+     * The text for the block. The minimum length is 1 character.
+     */
     private String text;
 }