align with style docs

Author: lucia

docs/filtering-and-sorting.md

@@ -19,8 +19,8 @@ there's no point fetching rows you won't use. These methods are for the
 result you already have: one loaded collection sliced different ways for
 different parts of the page, with no extra queries.
 
-The `where()` method keeps the rows where a field matches a value. Chain it
-to match on more than one field:
+`where()` keeps the rows where a field matches a value. Chain it to match on
+more than one field:
 
 ```php
 use Itools\SmartArray\SmartArrayHtml;
@@ -115,10 +115,10 @@ original keys; chain `values()` when you want them renumbered.
 
 ## Sorting: sortBy() and sort()
 
-The `sortBy()` method orders rows by a field. It returns a new sorted
-collection and never modifies the original (PHP's own `sort()` modifies
-arrays in place; SmartArray methods don't), so your result stays in query
-order and can be sorted different ways for different spots on the page:
+`sortBy()` orders rows by a field. It returns a new sorted collection and
+never modifies the original (PHP's own `sort()` modifies arrays in place;
+SmartArray methods don't), so your result stays in query order and can be
+sorted different ways for different spots on the page:
 
 ```php
 $funds = SmartArrayHtml::new([
@@ -144,10 +144,10 @@ echo $tags->sort()->implode(', ');  // Apache, MySQL, PHP
 
 ## Duplicates and Membership: unique() and contains()
 
-The `unique()` method drops repeated values from a flat list, keeping the first
-of each, and `contains()` to ask whether a value is in the list at all.
-Both treat `1` and `'1'` as the same value (`contains()` follows the same
-matching rules as `where()`):
+`unique()` drops repeated values from a flat list, keeping the first of each,
+and `contains()` to ask whether a value is in the list at all. Both treat `1`
+and `'1'` as the same value (`contains()` follows the same matching rules as
+`where()`):
 
 ```php
 $tags = SmartArrayHtml::new(['PHP', 'MySQL', 'PHP', 'Apache']);

docs/getting-started.md

@@ -97,10 +97,10 @@ if ($users->isEmpty()) {
 }
 
 foreach ($users as $user) {
-    echo "<li>$user->name - {$user->phone->or('no phone on file')}</li>\n";
+    echo "<li>$user->name - {$user->phone->or('(no phone)')}</li>\n";
 }
 // <li>Jean O&​apos;Brien - 604-555-1234</li>
-// <li>Sam Smith - no phone on file</li>
+// <li>Sam Smith - (no phone)</li>
 ```
 
 No `else` is needed: a `foreach` over an empty collection runs zero times.

docs/transforming-and-grouping.md

@@ -13,8 +13,8 @@ Contents:
 
 ## Pulling One Column: column()
 
-The `column()` method returns a flat list of one field from every row, like
-PHP's `array_column()` (including the keyed form below):
+`column()` returns a flat list of one field from every row, like PHP's
+`array_column()` (including the keyed form below):
 
 ```php
 use Itools\SmartArray\SmartArrayHtml;
@@ -39,8 +39,8 @@ echo $nameById->{7};  // Alice Munro
 
 ## Keying Rows for Lookups: indexBy()
 
-The `indexBy()` method keys whole rows by a field, turning "loop until you find
-it" into a direct lookup:
+`indexBy()` keys whole rows by a field, turning "loop until you find it" into
+a direct lookup:
 
 ```php
 $authorsById = $authors->indexBy('author_id');
@@ -100,8 +100,8 @@ keys are trusted values you defined yourself.
 
 ## Reshaping Rows: map()
 
-The `map()` method rebuilds each element with a callback. Like `filter()`, the
-callback receives plain PHP values, so you write ordinary PHP inside it:
+`map()` rebuilds each element with a callback. Like `filter()`, the callback
+receives plain PHP values, so you write ordinary PHP inside it:
 
 ```php
 $labels = $authors->map(fn($a) => "$a[name] ($a[city])");

docs/without-smartstrings.md

@@ -50,9 +50,9 @@ above: every selected column exists on every row, so a truly missing key
 means a typo, and typos on result rows warn on their own. Missing keys as a
 normal case only come up in arrays you assemble yourself.
 
-The `??` operator doesn't fire on stored `""`, because an empty string is a
-stored value. On the HTML side, use `or()` instead; it covers `""` and keeps
-fallbacks encoded (see [Displaying Fields](displaying-fields.md)).
+`??` doesn't fire on stored `""`, because an empty string is a stored value.
+On the HTML side, use `or()` instead; it covers `""` and keeps fallbacks
+encoded (see [Displaying Fields](displaying-fields.md)).
 
 In hand-built arrays, stick with `??` rather than a truthiness check: a
 key that doesn't exist at all comes back as a placeholder object so

tests/Integration/DocsExamplesTest.php

@@ -156,12 +156,12 @@ public function testGettingStartedIsEmptyGuardAndOrFallback(): void
             }
 
             foreach ($users as $user) {
-                echo "<li>$user->name - {$user->phone->or('no phone on file')}</li>\n";
+                echo "<li>$user->name - {$user->phone->or('(no phone)')}</li>\n";
             }
         });
 
         $this->assertSame(
-            "<li>Jean O&apos;Brien - 604-555-1234</li>\n<li>Sam Smith - no phone on file</li>\n",
+            "<li>Jean O&apos;Brien - 604-555-1234</li>\n<li>Sam Smith - (no phone)</li>\n",
             $output
         );
     }