diff --git a/.spelling b/.spelling
index 6b1cc753b..7e6b3aa1e 100644
--- a/.spelling
+++ b/.spelling
@@ -503,6 +503,7 @@ throw-testcasesItMockDescribe
 Gitter
 microsoft.com
 msi
+omnisharp-vscode
 opencode
 pkg
  - src/libpsl-native/README.md
diff --git a/README.md b/README.md
index 47ac384f5..9782c8d4b 100644
--- a/README.md
+++ b/README.md
@@ -141,6 +141,16 @@ See [working with the PowerShell repository](docs/git) for more information.
 
 ## Developing and Contributing
 
+> Note: To develop with VSCode on OSX and Linux, you need to install the [`v1.11.0-beta4`][beta-csharp] C# extension by following these [instructions][install-beta-csharp].
+>
+> PowerShell is building against the .NET Core `2.0.0-preview2` packages using the .NET Core `2.0.0-preview2` SDK.
+`v1.13.0` VSCode + `v1.10.0` C# extension works fine with the .NET Core `2.0.0-preview2` SDK on Windows.
+However, on OSX and Linux you need to use the `v1.11.0-beta4` C# extension due to [omnisharp-vscode issue #1495][omnisharp-1495].
+
+[beta-csharp]: https://github.com/OmniSharp/omnisharp-vscode/releases/tag/v1.11.0-beta4
+[install-beta-csharp]: https://github.com/OmniSharp/omnisharp-vscode/wiki/Installing-Beta-Releases
+[omnisharp-1495]: https://github.com/OmniSharp/omnisharp-vscode/issues/1495
+
 Please see the [Contribution Guide][] for how to develop and contribute.
 
 If you have any problems, please consult the [known issues][], developer [FAQ][], and [GitHub issues][].