Add sensible setup for vscode (#2085)

* Add CmakePresets.json file with the default Debug build. This actually
works for Cmake itself without vscode.

  `cmake --preset debug`

* add `ide.md` to describe how to setup vscode to get intellisense and
to use the CMakePresets.json file

End result of this should be that CMake works nicely in vscode **with**
clangd intellsense information


![image](https://github.com/openxla/stablehlo/assets/605070/1d0b5123-21f0-4e39-adef-9ae194d4ded2)

Author: Farid Zakaria

CMakePresets.json

@@ -0,0 +1,24 @@
+{
+    "version": 6,
+    "configurePresets": [
+        {
+          "name": "debug",
+          "displayName": "Debug w/ ccache",
+          "generator": "Ninja",
+          "binaryDir": "build/",
+          "cacheVariables": {
+            "CMAKE_BUILD_TYPE": "Debug",
+            "LLVM_ENABLE_ASSERTIONS": "ON",
+            "LLVM_ENABLE_LLD": "ON",
+            "STABLEHLO_ENABLE_BINDINGS_PYTHON" : "OFF",
+            "STABLEHLO_ENABLE_SPLIT_DWARF": "ON",
+            "CMAKE_CXX_COMPILER_LAUNCHER": "ccache",
+            "CMAKE_CXX_COMPILER": "clang++",
+            "CMAKE_C_COMPILER_LAUNCHER": "ccache",
+            "CMAKE_C_COMPILER": "clang",
+            "CMAKE_EXPORT_COMPILE_COMMANDS": "ON",
+            "MLIR_DIR": "${sourceDir}/llvm-build/lib/cmake/mlir"
+          }
+        }
+      ]
+  }

build_tools/github_actions/lint_check_license.sh

@@ -51,6 +51,7 @@ echo
 SKIPPED_SUFFIXES=(
   .clang-format
   .gitignore
+  .json
   .md
   .mlir
   .mlir.bc

docs/ide.md

@@ -0,0 +1,39 @@
+# IDE setup
+
+You can find on this page some _opinionated_ IDE setup instructions.
+Of course the best IDE is the one that _works for you_.
+
+> If you have an improvement or recommendation to any of the setups, we welcome contributions.
+
+## Visual Studio Code (vscode)
+
+### CMake
+
+Visual Studio Code (vscode) can work pretty well with the CMake build system.
+
+The following extensions are recommended:
+
+* [CMake Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools)
+* [clangd](https://marketplace.visualstudio.com/items?itemName=llvm-vs-code-extensions.vscode-clangd)
+
+> Note: Installing the `clangd` extension will inform you that you
+will need to disable the default _intellisense_ extension.
+This is fine, as `clangd` will provide the same functionality.
+
+We include a [CmakePresets.json](../CMakePresets.json) file in the root of the repository.
+This file is used by the `CMake Tools` extensionto provide a list of _presets_ that
+can be used to configure the build.  The `CMake Tools` extension will automatically
+detect this file and provide the presets.
+
+Additionally, all the configured presets generate the `compile_commands.json` file
+in the build directory which will then be picked up by `clangd`.
+
+We recommend additionally setting the following in your `.vscode/settings.json` file:
+
+```json
+{
+    "files.exclude": {
+        "**/bazel-*": true
+    }
+}
+```