docs(ch11): note the VoiceOver "selection replaced" announcement (#262)

Reassure macOS learners that nothing is replaced, give the one thing already
ruled out, and point to #175 for reports. Refs #175.


Claude-Session: https://claude.ai/code/session_01PmRBrUTuhzYnQBFxUCN6Vr

Co-authored-by: Claude <noreply@anthropic.com>

Author: accesswatch

docs/11-vscode-interface.md

@@ -412,6 +412,8 @@ VS Code uses a web-based renderer. Configure NVDA for best results:
 3. Use Quick Nav OFF (`Left+Right Arrow`) when inside the editor - standard cursor navigation is more predictable
 4. Use `VO+Shift+Down` to interact with the editor, `VO+Shift+Up` to stop interacting
 
+> **If VoiceOver says "selection replaced" when you type:** some learners on macOS hear "selection replaced" when they type the first character in a file in the editor, in a new file or an existing one. Nothing has been replaced: your text is intact, and you can check by reading the line with `VO+L`. The cause is not yet known, and the same announcement has been reported in other Markdown editors, so it may come from VoiceOver rather than VS Code. Turning off macOS text replacements did not stop it. If it happens to you, add your macOS, VoiceOver and VS Code versions to [issue #175](https://github.com/Community-Access/git-going-with-github/issues/175) so we can narrow it down.
+
 ### Learning Cards: Screen Reader Mode
 
 <details>

html/docs/11-vscode-interface.html

@@ -758,6 +758,9 @@ <h3 id="voiceover-specific-settings-for-vs-code-macos">VoiceOver-Specific Settin
 <li>Use Quick Nav OFF (<code>Left+Right Arrow</code>) when inside the editor - standard cursor navigation is more predictable</li>
 <li>Use <code>VO+Shift+Down</code> to interact with the editor, <code>VO+Shift+Up</code> to stop interacting</li>
 </ol>
+<blockquote>
+<p><strong>If VoiceOver says &quot;selection replaced&quot; when you type:</strong> some learners on macOS hear &quot;selection replaced&quot; when they type the first character in a file in the editor, in a new file or an existing one. Nothing has been replaced: your text is intact, and you can check by reading the line with <code>VO+L</code>. The cause is not yet known, and the same announcement has been reported in other Markdown editors, so it may come from VoiceOver rather than VS Code. Turning off macOS text replacements did not stop it. If it happens to you, add your macOS, VoiceOver and VS Code versions to <a href="https://github.com/Community-Access/git-going-with-github/issues/175">issue #175</a> so we can narrow it down.</p>
+</blockquote>
 <h3 id="learning-cards-screen-reader-mode">Learning Cards: Screen Reader Mode</h3>
 <details>
 <summary>Screen reader users</summary>