message: [XLA] [Docs] Further clarify nesting jit_compile behavior
diff: @@ -87,6 +87,9 @@ recompiled_on_launch(tf.ones([1, 10]), tf.ones([1, 10]))
  recompiled_on_launch(tf.ones([1, 100]), tf.ones([1, 100]))
  ```
  +Note: Nesting behavior: the function will be compiled if at least one function
  +in its call stack has `jit_compile=True`.
  +
  See the [tutorial colab](./tutorials/jit_compile.ipynb) for a more detailed
  usage example.
  @@ -94,10 +97,12 @@ usage example.
  A simple way to start using XLA in TensorFlow models without any changes is to
  enable _auto-clustering_, which automatically finds _clusters_ (connected
  -subgraphs) within the TensorFlow graph which can be compiled and executed using
  -XLA. Auto-clustering on GPU can be enabled by setting the `TF_XLA_FLAGS`
  +subgraphs) within the TensorFlow functions which can be compiled and executed
  +using XLA. Auto-clustering on GPU can be enabled by setting the `TF_XLA_FLAGS`
  environment variable:
  +Note: In TF2, only the code inside `tf.function` will be clustered.
  +
  ```
  $ TF_XLA_FLAGS=--tf_xla_auto_jit=2 path/to/your/tf/program
  ```
  @@ -173,6 +178,16 @@ a bug to a single XLA program by using the
  [`replay_computation`](https://github.com/tensorflow/tensorflow/blob/master/tensorflow/compiler/xla/tools/run_hlo_module_main.cc)
  and iteratively running it on generated programs.
  +## Further reading
  +
  +- [Known Issues](./known_issues.md) List of known issues with XLA
  +- [XLA Architecture](./architecture.md): Overview of the XLA architecture
  +- [XLA - TensorFlow, Compiled](https://developers.googleblog.com/2017/03/xla-tensorflow-compiled.html):
  + Read on Google Developers Blog
  +- Check out the
  + [XLA source](https://github.com/tensorflow/tensorflow/tree/master/tensorflow/compiler/xla)
  + on Github!
  +
  ## XLA Frontends
  Apart from TensorFlow, XLA programs can be generated by:
  @@ -183,15 +198,6 @@ Apart from TensorFlow, XLA programs can be generated by:
  scientific computing
  - [PyTorch](https://github.com/pytorch/xla): PyTorch framework
  -## Further reading
  -
  -- [XLA Architecture](./architecture.md): Overview of the XLA architecture
  -- [XLA - TensorFlow, Compiled](https://developers.googleblog.com/2017/03/xla-tensorflow-compiled.html):
  - Read on Google Developers Blog
  -- Check out the
  - [XLA source](https://github.com/tensorflow/tensorflow/tree/master/tensorflow/compiler/xla)
  - on Github!
  -
  <iframe frameborder="0" allow="accelerometer; autoplay;
  encrypted-media; gyroscope; picture-in-picture; fullscreen" width="640" height="360"
  src="https://www.youtube.com/embed/kAOanJczHA0?origin=https%3A%2F%2Fwww.tensorflow.org&amp;autohide=1&amp;showinfo=0&amp;video-id=kAOanJczHA0&amp;enablejsapi=1&amp;widgetid=1"
  