Move better transformer tutorial, update index (#1982)

* Adding better transformer tutorial
* remove bt from prod toc

Author: mikekgfb

intermediate_source/bettertransformer_tutorial.rst renamed to beginner_source/bettertransformer_tutorial.rst

@@ -127,14 +127,14 @@ We run the model on CPU, and collect profile information:
 * The first run uses traditional ("slow path") execution.
 * The second run enables BT fastpath execution by putting the model in inference mode using `model.eval()` and disables gradient collection with `torch.no_grad()`.
 
-You can see a small improvement when the model is executing on CPU.  Notice that the fastpath profile shows most of the execution time
+You can see an improvement (whose magnitude will depend on the CPU model) when the model is executing on CPU.  Notice that the fastpath profile shows most of the execution time
 in the native `TransformerEncoderLayer` implementation `aten::_transformer_encoder_layer_fwd`.
 
 .. code-block:: python
 
     print("slow path:")
     print("==========")
-    with torch.autograd.profiler.profile(use_cuda=True) as prof:
+    with torch.autograd.profiler.profile(use_cuda=False) as prof:
       for i in range(ITERATIONS):  
         output = model(model_input)
     print(prof)
@@ -143,7 +143,7 @@ in the native `TransformerEncoderLayer` implementation `aten::_transformer_encod
 
     print("fast path:")
     print("==========")
-    with torch.autograd.profiler.profile(use_cuda=True) as prof:
+    with torch.autograd.profiler.profile(use_cuda=False) as prof:
       with torch.no_grad():
         for i in range(ITERATIONS):
           output = model(model_input)

index.rst

@@ -3,7 +3,7 @@ Welcome to PyTorch Tutorials
 
 What's new in PyTorch tutorials?
 
-* `Fast Transformer Inference with Better Transformer <https://pytorch.org/tutorials/intermediate/bettertransformer_tutorial.html?utm_source=whats_new_tutorials&utm_medium=bettertransformer>`__
+* `Fast Transformer Inference with Better Transformer <https://pytorch.org/tutorials/beginner/bettertransformer_tutorial.html?utm_source=whats_new_tutorials&utm_medium=bettertransformer>`__
 * `Introduction to TorchRec <https://pytorch.org/tutorials/intermediate/torchrec_tutorial.html?utm_source=whats_new_tutorials&utm_medium=torchrec>`__
 * `Getting Started with Fully Sharded Data Parallel (FSDP) <https://pytorch.org/tutorials/intermediate/FSDP_tutorial.html?utm_source=whats_new_tutorials&utm_medium=FSDP>`__
 * `Advanced model training with Fully Sharded Data Parallel (FSDP) <https://pytorch.org/tutorials/intermediate/FSDP_adavnced_tutorial.html?utm_source=whats_new_tutorials&utm_medium=FSDP_advanced>`__
@@ -214,6 +214,13 @@ What's new in PyTorch tutorials?
 
 .. Text
 
+.. customcarditem::
+   :header: Fast Transformer Inference with Better Transformer
+   :card_description: Deploy a PyTorch Transformer model using Better Transformer with high performance for inference
+   :image: _static/img/thumbnails/cropped/pytorch-logo.png
+   :link: beginner/bettertransformer_tutorial.html
+   :tags: Production,Text
+
 .. customcarditem::
    :header: Sequence-to-Sequence Modeling with nn.Transformer and torchtext
    :card_description: Learn how to train a sequence-to-sequence model that uses the nn.Transformer module.
@@ -276,13 +283,6 @@ What's new in PyTorch tutorials?
 
 .. Deploying PyTorch Models in Production
 
-.. customcarditem::
-   :header: Fast Transformer Inference with Better Transformer
-   :card_description: Deploy a PyTorch Transformer model using Better Transformer with high performance for inference
-   :image: _static/img/thumbnails/cropped/pytorch-logo.png
-   :link: intermediate/bettertransformer_tutorial.html
-   :tags: Production,Text
-
 
 .. customcarditem::
    :header: Deploying PyTorch in Python via a REST API with Flask
@@ -782,6 +782,7 @@ Additional Resources
    :caption: Text
 
    beginner/transformer_tutorial
+   beginner/bettertransformer_tutorial
    intermediate/char_rnn_classification_tutorial
    intermediate/char_rnn_generation_tutorial
    intermediate/seq2seq_translation_tutorial
@@ -804,7 +805,6 @@ Additional Resources
    :hidden:
    :caption: Deploying PyTorch Models in Production
 
-   intermediate/bettertransformer_tutorial
    intermediate/flask_rest_api_tutorial
    beginner/Intro_to_TorchScript_tutorial
    advanced/cpp_export