Merge branch '211595-sourcegraph-documentation' into 'master'

Resolve "Sourcegraph documentation"

Closes #211595

See merge request gitlab-org/gitlab!27454

doc/integration/sourcegraph.md

@@ -4,7 +4,8 @@ type: reference, how-to
 
 # Sourcegraph integration
 
-> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/16556) in GitLab 12.5. Please note that this integration is in BETA and [behind a feature flag](#enable-the-sourcegraph-feature-flag).
+> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/16556) in GitLab 12.5.
+> - Note that this integration is in BETA and deployed [behind a feature flag](#enable-the-sourcegraph-feature-flag) disabled by default. Self-managed instances can opt to enable it.
 
 [Sourcegraph](https://sourcegraph.com) provides code intelligence features, natively integrated into the GitLab UI.
 
@@ -106,18 +107,17 @@ When visiting one of these views, you can now hover over a code reference to see
 
 ## Sourcegraph for GitLab.com
 
-Sourcegraph powered code intelligence will be incrementally rolled out on GitLab.com.
-It will eventually become available for all public projects, but for now, it is only
-available for some specific projects within the [`gitlab-org`](https://gitlab.com/gitlab-org/)
-group, e.g., <https://gitlab.com/gitlab-org/gitlab>. This means that you can see
-it working and use it to dig into the code of these projects, but you cannot use
-it on your own project on GitLab.com yet.
+Sourcegraph powered code intelligence is avaialable for all public projects on GitLab.com.
 
-If you would like to use it in your own projects as of GitLab 12.5, you can do so by
-setting up a self-managed GitLab instance.
+Support for private projects is currently not available for GitLab.com;
+follow the epic [&2201](https://gitlab.com/groups/gitlab-org/-/epics/2201)
+for updates.
 
-Follow the epic [&2201](https://gitlab.com/groups/gitlab-org/-/epics/2201) for
-updates.
+## Troubleshooting
+
+### Sourcegraph isn't working
+
+If you enabled Sourcegraph for your project but still it doesn't looklike it's working, it might be because Sourcegraph has not indexed theproject yet. You can check for Sourcegraph's availability of your project by visiting `https://sourcegraph.com/gitlab.com/<project-path>`replacing `<project-path>` with the path to your GitLab project.
 
 ## Sourcegraph and Privacy