docs: mention remote caching in BES documentation
cc:
Closes
@@ -218,6 +218,22 @@ authentication and TLS infrastructure.
For a description of each of these flags, see the
[Command-Line Reference](command-line-reference.html).
+### Build Event Service and Remote Caching
+
+The BEP typically contains many references to log files (test.log, test.xml,
+etc. ) stored on the machine where Bazel is running. A remote BES server
+typically can't access these files as they are on different machines. A way
+to work around this issue is to use Bazel with [remote caching]. Bazel will
+upload all output files to the remote cache (including files referenced in
+the BEP) and the BES server can then fetch the referenced files from the
+cache.
+
+See [GitHub issue 3689] for more details.
+
+[remote caching](https://github.com/bazelbuild/bazel/blob/master/src/main/java/com/google/devtools/build/lib/remote/README.md)
+
+[GitHub issue 3689](https://github.com/bazelbuild/bazel/issues/3689)
+
[Build Event Protocol]:
https://github.com/bazelbuild/bazel/blob/master/src/main/java/com/google/devtools/build/lib/buildeventstream/proto/build_event_stream.proto
