Merge pull request #112 from tbrowder/pod-table-fix

further amplify table row and cell requirments and recommendations

Author: tbrowder

S26-documentation.pod

@@ -1427,10 +1427,13 @@ Rows can be specified in one of two ways: either one row per line, with
 no separators; or multiple lines per row with explicit horizontal
 separators (whitespace, intersections (C<+>), or horizontal lines: C<->,
 C<=>, C<_>) between I<every> row. Either style can also have an
-explicitly separated header row at the top.
+explicitly separated header row at the top. If rows are using the
+two-whitespace-character separator, the row cells should be carefully
+aligned to ensure the table is interpreted as the user intended.
 
 Each individual table cell is separately formatted, as if it were a
-nested C<=para>.
+nested C<=para>. Note that table rows are expected to have the same number
+of cells.
 
 This means you can create tables compactly, line-by-line: