Add some bazel configuration notes found in practice.
diff --git a/docs/website/docs/building-from-source/optional-features.md b/docs/website/docs/building-from-source/optional-features.md index 09a27f5..216f63e 100644 --- a/docs/website/docs/building-from-source/optional-features.md +++ b/docs/website/docs/building-from-source/optional-features.md
@@ -178,7 +178,7 @@ ``` shell # From the iree source directory. cd integrations/tensorflow - python ../../configure_bazel.py + CC=clang CXX=clang python ../../configure_bazel.py bazel build iree_tf_compiler:importer-binaries ``` @@ -194,6 +194,22 @@ Importer binaries can be found under `bazel-bin/iree_tf_compiler` and can be used from the command line if desired. + +???+ Note + Bazel's default configuration tends to build almost everything twice, + for reasons that can only be surmised to be based in some technically + correct but practically challenged viewpoint. It is also incompatible with + ccache and other mechanisms for performing less incremental work. It is + recommended to address both of these with a `.bazelrc` file in your + home directory: + + ``` + build --disk_cache=/path/to/home/.bazelcache + build --nodistinct_host_configuration + ``` + + We can't set these for you because of other inscrutable reasons. + ### IREE The main IREE build will embed binaries built above and enable additional