fix(docs): Correct parity docs from verification pass

- Remove duplicate 'Attach on create' row in comparison table, keep
  corrected version with '(default: true)' near socket_path
- Annotate pre_tab as (deprecated) in comparison table
- Annotate startup_window as accepting name or index
- Fix pre_tab description: deprecated predecessor, not alias (it was
  renamed in tmuxinator, not aliased)
- Clarify startup_window renders as "#{name}:#{value}"

Author: tony

docs/comparison.md

@@ -53,15 +53,15 @@ teamocil parses YAML into `Session`/`Window`/`Pane` objects, each producing `Com
 | Windows list | `windows` | `windows` / `tabs` | `windows` |
 | Socket name | (CLI `-L`) | `socket_name` | (none) |
 | Socket path | (CLI `-S`) | `socket_path` | (none) |
+| Attach on create | (CLI `-d` to detach) | `attach` (default: true) | (always attaches) |
 | Tmux config file | (CLI `-f`) | `tmux_options` / `cli_args` | (none) |
 | Tmux command | (none) | `tmux_command` (e.g. `wemux`) | (none) |
 | Session options | `options` | (none) | (none) |
 | Global options | `global_options` | (none) | (none) |
 | Environment vars | `environment` | (none) | (none) |
 | Pre-build script | `before_script` | (none) | (none) |
-| Shell cmd before (all panes) | `shell_command_before` | `pre_window` / `pre_tab` | (none) |
-| Attach on create | (CLI `-d` to detach) | `attach` | (always attaches) |
-| Startup window | (none) | `startup_window` | (none) |
+| Shell cmd before (all panes) | `shell_command_before` | `pre_window` / `pre_tab` (deprecated) | (none) |
+| Startup window | (none) | `startup_window` (name or index) | (none) |
 | Startup pane | (none) | `startup_pane` | (none) |
 | Plugins | `plugins` | (none) | (none) |
 | ERB/variable interpolation | (none) | Yes (`key=value` args) | (none) |

notes/import-tmuxinator.md

@@ -125,7 +125,7 @@ These are config keys/patterns that differ syntactically but can be automaticall
 |---|---|
 | `pre_tab: "source .env"` | `shell_command_before: ["source .env"]` |
 
-**Importer status**: ✗ Not handled. `pre_tab` is a deprecated alias for `pre_window`.
+**Importer status**: ✗ Not handled. `pre_tab` is a deprecated predecessor to `pre_window` (not an alias — it was renamed).
 
 ### 15. `rvm` → `shell_command_before`
 

notes/parity-tmuxinator.md

@@ -56,7 +56,7 @@ startup_window: editor      # Select this window after build
 startup_pane: 1              # Select this pane within the startup window
 ```
 
-**Gap**: tmuxp supports `focus: true` on windows and panes (boolean), which is equivalent but syntactically different. The `startup_window` key allows referencing by name or index. **Partial parity** — tmuxp can achieve this but uses a different mechanism (`focus` key on individual windows/panes).
+**Gap**: tmuxp supports `focus: true` on windows and panes (boolean), which is equivalent but syntactically different. The `startup_window` key allows referencing by name or index (rendered as `"#{name}:#{value}"`). **Partial parity** — tmuxp can achieve this but uses a different mechanism (`focus` key on individual windows/panes rather than a centralized key).
 
 ### 5. Pane Synchronization
 
@@ -217,7 +217,7 @@ Creates a config file pre-populated from a running tmux session.
 | `startup_pane` | Not imported. tmuxp uses `focus: true` on panes. |
 | `tmux_command` | Not imported. tmuxp has no equivalent. |
 | `socket_path` | Not imported. tmuxp takes this via CLI. |
-| `pre_tab` | Not imported (alias for `pre_window`). |
+| `pre_tab` | Not imported (deprecated predecessor to `pre_window`). |
 | `rvm` | Not imported (only `rbenv` is handled). |
 | `post` | Not imported. tmuxp has no equivalent. |
 | `synchronize` | Not imported. tmuxp has no equivalent. |
@@ -241,7 +241,7 @@ Creates a config file pre-populated from a running tmux session.
 
 3. **Line 79-101**: The window iteration uses `for k, v in window_dict.items()` which assumes windows are always dicts with a single key (the window name). This is correct for tmuxinator's format but fragile — if a window dict has multiple keys, only the last one is processed.
 
-4. **Missing `pre_tab`**: The `pre_tab` alias for `pre_window` is not handled.
+4. **Missing `pre_tab`**: The `pre_tab` deprecated predecessor to `pre_window` is not handled.
 
 5. **Missing `rvm`**: Only `rbenv` is imported; `rvm` (another deprecated but still functional key) is ignored.