Document TableRowInkWell and DataTable interactions better (#73018)

packages/flutter/lib/src/material/data_table.dart

@@ -133,6 +133,10 @@ class DataRow {
   /// A row whose [onSelectChanged] callback is null is ignored for
   /// the purposes of determining the state of the "all" checkbox,
   /// and its checkbox is disabled.
+  ///
+  /// If a [DataCell] in the row has its [DataCell.onTap] callback defined,
+  /// that callback behavior overrides the gesture behavior of the row for
+  /// that particular cell.
   final ValueChanged<bool?>? onSelectChanged;
 
   /// Whether the row is selected.
@@ -240,6 +244,9 @@ class DataCell {
   /// If non-null, tapping the cell will call this callback. If
   /// null, tapping the cell will attempt to select the row (if
   /// [DataRow.onSelectChanged] is provided).
+  ///
+  /// To define a tap behavior for the entire row, see
+  /// [DataRow.onSelectChanged].
   final VoidCallback? onTap;
 
   bool get _debugInteractive => onTap != null;
@@ -1028,6 +1035,12 @@ class DataTable extends StatelessWidget {
 /// thus the splash will not occur. (In general, this is easy to
 /// achieve: just put the [TableRowInkWell] as the direct child of the
 /// [Table], and put the other contents of the cell inside it.)
+///
+/// See also:
+///
+///  * [DataTable], which makes use of [TableRowInkWell] when
+///    [DataRow.onSelectChanged] is defined and [DataCell.onTap]
+///    is not.
 class TableRowInkWell extends InkResponse {
   /// Creates an ink well for a table row.
   const TableRowInkWell({