Update python docs to reference new propagator pkg (#188)

* Update python docs to reference new propagator pkg

* Add link to docs on X-Ray tracing header

Author: NathanielRN

src/docs/getting-started/python-sdk/trace-auto-instr.mdx

@@ -11,7 +11,7 @@ import SubSectionSeparator from "components/MdxSubSectionSeparator/subsectionSep
 
 ## Introduction
 
-OpenTelemetry Python supports automatic instrumentation. It automatically produces spans with telemetry data describing the values used by the python frameworks in your application without adding a single line of code. This telemetry data can then be exported to a backend like AWS X-Ray using the ADOT Python `opentelemetry-sdk-extension-aws` package.
+OpenTelemetry Python supports automatic instrumentation. It automatically produces spans with telemetry data describing the values used by the python frameworks in your application without adding a single line of code. This telemetry data can then be exported to a backend like AWS X-Ray using the ADOT Python `opentelemetry-sdk-extension-aws` package. We also strongly recommend using the `opentelemetry-propagator-aws-xray` package to support propagating the trace context across AWS services. This propagator handles the extraction and injecting of the [AWS X-Ray Tracing header](https://docs.aws.amazon.com/xray/latest/devguide/xray-concepts.html#xray-concepts-tracingheader) for requests from or to remote services.
 
 In this guide, we walk through the steps needed to trace an application with auto-instrumentation.
 
@@ -32,10 +32,13 @@ The easiest way to download the packages needed for auto-instrumentation is usin
 ```bash
 # Install required packages for instrumentation and to support tracing with AWS X-Ray
 $ pip install opentelemetry-distro[otlp]>=0.24b0 \
-              opentelemetry-sdk-extension-aws~=1.0
+              opentelemetry-sdk-extension-aws~=2.0 \
+              opentelemetry-propagator-aws-xray~=1.0
 ```
 
-Installing the `opentelemetry-sdk-extension-aws` package automatically installs the `opentelemetry-api`, `opentelemetry-sdk`, and `opentelemetry-instrumentation` packages as dependencies.
+The `opentelemetry-distro` package provides methods which configure the OpenTelemetry SDK with some basic defaults. These methods are used by Auto Instrumentation. Because you added the `[otlp]` "extra" command, the `opentelemetry-exporter-otlp` package (used to send traces to the ADOT Collector) is also automatically installed.
+
+Installing the `opentelemetry-sdk-extension-aws` package automatically installs the `opentelemetry-api`, `opentelemetry-sdk`, and `opentelemetry-instrumentation` packages as dependencies. You also need the `opentelemetry-propagator-aws-xray` package to obtain the `AwsXRayPropagator` class used to propagate the trace context across AWS services.
 
 `opentelemetry-instrumentation` provides commands to detect, install, and initialize all instrumentation packages supported for your application’s dependencies. Notably, it installs the `opentelemetry-bootstrap` and `opentelemetry-instrument` executables on your system.
 

src/docs/getting-started/python-sdk/trace-manual-instr.mdx

@@ -11,7 +11,7 @@ import SubSectionSeparator from "components/MdxSubSectionSeparator/subsectionSep
 
 ## Introduction
 
-With OpenTelemetry Python manual instrumentation, you configure the OpenTelemetry SDK within your application's code. It automatically produces spans with telemetry data describing the values used by the Python frameworks in your application with only a few lines of code. This telemetry data can then be exported to a backend like AWS X-Ray using the ADOT Python `opentelemetry-sdk-extension-aws` package.
+With OpenTelemetry Python manual instrumentation, you configure the OpenTelemetry SDK within your application's code. It automatically produces spans with telemetry data describing the values used by the Python frameworks in your application with only a few lines of code. This telemetry data can then be exported to a backend like AWS X-Ray using the ADOT Python `opentelemetry-sdk-extension-aws` package. We also strongly recommend using the `opentelemetry-propagator-aws-xray` package to support propagating the trace context across AWS services. This propagator handles the extraction and injecting of the [AWS X-Ray Tracing header](https://docs.aws.amazon.com/xray/latest/devguide/xray-concepts.html#xray-concepts-tracingheader) for requests from or to remote services.
 
 In this guide, we walk through the steps needed to trace an application with auto instrumentation.
 
@@ -30,7 +30,8 @@ Note: You’ll also need to have the [ADOT Collector](https://aws-otel.github.io
 Install the following packages and its dependencies from OpenTelemetry Python using pip.
 
 ```bash
-$ pip install opentelemetry-sdk-extension-aws~=1.0 \
+$ pip install opentelemetry-sdk-extension-aws~=2.0 \
+              opentelemetry-propagator-aws-xray~=1.0 \
               opentelemetry-exporter-otlp~=1.5 \
 ```
 
@@ -93,13 +94,13 @@ Instead of setting the `IdGenerator` of the `TracerProvider` in code, you can al
 OTEL_PYTHON_ID_GENERATOR=xray
 ```
 
-To allow the span context to propagate downstream when the application makes calls to external services, configure the global propagator to use the AWS X-Ray Propagator. You can set the global propagator in code, and should configure the propagator as soon as possible in your application's code.
+To allow the span context to propagate downstream when the application makes calls to external services, configure the global propagator to use the AWS X-Ray Propagator, which is found in the `opentelemetry-propagator-aws-xray` package. You can set the global propagator in code, and should configure the propagator as soon as possible in your application's code.
 
 
 ```python lineNumbers=true
 from opentelemetry import propagate
-from opentelemetry.sdk.extension.aws.trace.propagation.aws_xray_format import AwsXRayFormat
-propagate.set_global_textmap(AwsXRayFormat())
+from opentelemetry.propagators.aws import AwsXRayPropagator
+propagate.set_global_textmap(AwsXRayPropagator())
 ```
 
 Alternatively, set the `OTEL_PROPAGATORS` environment variable to achieve the same result.