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
