PR comments

Author: antonsviridov-src

docs/code-search/code-navigation/syntactic_code_navigation.mdx

@@ -3,16 +3,16 @@
 <TierCallout>
   Supported on [Enterprise](/pricing/enterprise) plans.
   <user>
-   This feature is currently experimental and enabled by default for Cloud customers
+   This feature is currently in Beta and enabled by default for Cloud customers
   </user>
 </TierCallout>
 
-Syntactic code navigation is an opt-in zero configuration feature that improves code navigation for certain languages in the absence of
+Syntactic code navigation is a zero configuration feature that improves code navigation for certain languages in the absence of
 [Precise code navigation](./precise_code_navigation) set up. It works by periodically indexing repositories for which it is [enabled](#enabling-syntactic-code-navigation), using high level syntax analysis heuristics.
 
 This mechanism is more robust than search-based navigation, but less powerful than Precise code navigation.
 When syntactic indexing data is available for a given file and repository, it will be selected over search-based navigation automatically,
-but only if Precise data is not available. To summarise the order of priorities is as follows:
+but only if Precise data is not available. To summarize, the order of priorities is as follows:
 
 - Precise data
 - Syntactic, if no precise data available
@@ -37,6 +37,23 @@ Syntactic indexing can only be enabled if the policy type is set to HEAD – onl
 
 ## Supported languages
 
-Syntactic code navigation requires language-specific implementations, and we currently support the following languages: [Java](https://www.java.com/en/), [Go](https://go.dev/), [Scala](https://scala-lang.org).
+Syntactic code navigation requires language-specific implementations, and we currently support the following languages: 
 
-We are constantly looking to expand the list of supported languages, with Python, Typescript/Javascript, C, C++, C# planned. If you are interested in syntactic indexing for these or any other languages, please contact your Sourcegraph account representative.
+ - [Java](https://www.java.com/en/) 
+ - [Go](https://go.dev/)
+ - [Scala](https://scala-lang.org)
+ - [C#](https://learn.microsoft.com/en-us/dotnet/csharp/)
+ - [C++](https://isocpp.org/)
+
+We are constantly looking to expand the list of supported languages, with Python, Typescript/Javascript, and C planned. 
+If you are interested in syntactic indexing for these or any other languages, please contact your Sourcegraph account representative.
+
+## Comparison with Precise and Search-based
+
+Syntactic code navigation falls between Precise and Search-based code navigation both in terms of quality of navigation,
+and in terms of effort to maintain for different languages:
+
+![Comparison chart showing where different navigation modes are located in terms of effort to maintain and quality of results](https://storage.googleapis.com/sourcegraph-assets/Docs/code-navigation-levels-comparison.png)
+
+As the indexing does not involve build tools or actual compilers, it can be performed in isolated environment, with no network access
+and no configuration, unlike Precise.