Both counts ("two to six", "25 in total") would silently go stale if a
sub-category is ever added or removed. Reworded to "several" so the
prose no longer needs a manual update alongside the guard registry.
Troubleshooting's "Upgrading Fish by distribution" examples carried a
leading "# Arch / AUR"-style comment instead of a Starlight fence title.
Generalize the existing filename-comment title signal to any short
label comment (excluded when it reads as a sentence, e.g. ends in
punctuation) so it titles the block and is stripped from the body.
Also fixes two cases where shell examples fell back to an unhighlighted
```text block instead of ```fish:
- `_is_shell` only recognized a hardcoded command list, so any repo-only
command (fish-deps, config-settings, ...) was invisible to it even
though the same vocabulary already exists for codespans wrapping.
Now `_is_shell` reuses that one vocabulary instead of a second,
drifting one.
- A shell paragraph with its own nested indentation (a for/if/while
body) was routed past shell detection entirely by the `deeper` guard,
which exists for nested option tables. Shell detection now runs
regardless of `deeper`.
rootiest