docs/faq.md: update the vscode default text mate rule project

hyangah · hyangah · commit fe57357337c5 · 2024-05-01T15:00:11.000Z
VS Code changed its TextMate rule source to worlpaker/go-syntax. Change-Id: I5c59ac851731c388a2a8a317ed5a3c5ca0946a69 Reviewed-on: https://go-review.googlesource.com/c/vscode-go/+/582675 Reviewed-by: Peter Weinberger <pjw@google.com> Commit-Queue: Hyang-Ah Hana Kim <hyangah@gmail.com> kokoro-CI: kokoro <noreply+kokoro@google.com>
diff --git a/README.md b/README.md
@@ -95,7 +95,7 @@ extension.
 <br/><em>(Toggle Test File)</em></p>
 
 **&#9888;&#65039; Note**: the default syntax highlighting for Go files is provided by a
-[TextMate rule](https://github.com/jeff-hykin/better-go-syntax) embedded in VS
+[TextMate rule](https://github.com/worlpaker/go-syntax) embedded in VS
 Code, not by this extension.
 
 For better syntax highlighting, we recommend enabling
diff --git a/docs/faq.md b/docs/faq.md
@@ -5,17 +5,22 @@
 ## Syntax highlighting doesn't seem to work.
 
 The default syntax highlighting for Go files is provided by a
-[TextMate rule](https://github.com/jeff-hykin/better-go-syntax) embedded in VS Code,
+[TextMate rule](https://github.com/worlpaker/go-syntax) embedded in VS Code,
 not by this extension.
 
-For better syntax highlighting (including generics support), we recommend enabling
+For accurate syntax highlighting (including generics support), we recommend enabling
 [semantic highlighting](https://code.visualstudio.com/api/language-extensions/semantic-highlight-guide)
 by turning on [Gopls' `ui.semanticTokens` setting](settings.md#uisemantictokens).
 
 ```json
 "gopls": { "ui.semanticTokens": true }
 ```
 
+If you are experiencing issues with syntax highlighting, first check if you
+are using semantic highlighting. In case you did not enable semantic highlighting,
+report the issues to the [go-syntax](https://github.com/worlpaker/go-syntax)
+project directly.
+
 ## Code formatting by this extension doesn't seem to work.
 
 When you have multiple formatter extensions, be sure to set this
