IDE docs: Add more info and links to supported IDEs and editors

#3257

Closes #3627.

PiperOrigin-RevId: 167571696

1 files changed, 52 insertions, 14 deletions

diff --git a/site/docs/ide.md b/site/docs/ide.md
index 2a7f8abb5d..3d2e073bdd 100644
--- a/site/docs/ide.md
+++ b/site/docs/ide.md
@@ -5,28 +5,66 @@ title: IDE integration
 
 # Integrating Bazel with IDEs
 
-Bazel currently integrates with the following IDEs via third-party solutions:
+IDEs integrate with Bazel in a variety of ways, from features that allow Bazel executions from within the IDE, to awareness of Bazel structures such as syntax highlighting of the BUILD files.
 
-*  Android Studio
+## Supported IDEs and editors
 
-*  CLion
+### IntelliJ, Android Studio and CLion
 
-*  IntelliJ
+*Status*: Beta, supported by the Bazel team.
 
-*  Xcode
+[Plug-ins](http://ij.bazel.build) for Android Studio, CLion, and IntelliJ enable you to:
 
-## IDE plug-ins
+*  Import BUILD files into the IDE
+*  Make your IDE aware of Bazel's build and Skylark languages
+*  Build, test, and execute binaries directly from the IDE
 
-[Plug-ins](http://ij.bazel.build) for Android Studio, CLion, and IntelliJ
-enable you to:
+Installation:
 
-*  Import BUILD files into the IDE
+*  [Android Studio plugin](https://plugins.jetbrains.com/plugin/9185-android-studio-with-bazel)
+*  [CLion plugin](https://plugins.jetbrains.com/plugin/9554-clion-with-bazel)
+*  [IntelliJ plugin](https://plugins.jetbrains.com/plugin/8609-intellij-with-bazel)
 
-*  Make your IDE aware of Bazel's build and Skylark languages
+### Xcode
 
-*  Build, test, and execute binaries directly from the IDE
+*Status*: Beta, supported by the Bazel team.
+
+[Tulsi](http://tulsi.bazel.build) generates Bazel-compatible Xcode projects from Bazel's `BUILD` files.
+
+### Eclipse
+
+*Status*: experimental, not officially supported by the Bazel team.
+
+See [installation steps on GitHub](https://github.com/bazelbuild/eclipse#installation)
+
+
+### Visual Studio Code
+
+*Status*: not officially supported by the Bazel team.
+
+Provides syntax highlighting and formatting for Bazel `BUILD` and `WORKSPACE` files.
+
+See [Bazel in Visual Studio marketplace](https://marketplace.visualstudio.com/items?itemName=DevonDCarew.bazel-code)
+
+
+### Atom
+
+*Status*: not officially supported by the Bazel team.
+
+See [`language-bazel` package](https://atom.io/packages/language-bazel)
+
+
+
+### Vim
+
+*Status*: Beta, not officially supported by the Bazel team.
+
+https://github.com/bazelbuild/vim-bazel
+
+## Automatically run build and test on file change
+
+[Bazel watcher](https://github.com/bazelbuild/bazel-watcher) is a tool for building Bazel targets when source files change.
 
-## Tulsi
+## Building your own IDE plugin
 
-[Tulsi](http://tulsi.bazel.build) generates Bazel-compatible Xcode projects from
-Bazel's `BUILD` files.
+Read the [*IDE support* blog post](https://bazel.build/blog/2016/06/10/ide-support.html) to learn more about the Bazel APIs to used when building an IDE plugin.