Propagate API module & propagators package missing from API docs (ope…

…n-telemetry#2785)

* Propagate API module missing from docs.

* Add CHANGELOG.

* Sphinx complains about more missing classes.

* More fixes, understood why Sphinx didn't find some link targets.

* Update CHANGELOG.

CHANGELOG.md

@@ -41,6 +41,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   ([#2748](https://github.com/open-telemetry/opentelemetry-python/pull/2748))
 - Fix Jaeger propagator usage with NonRecordingSpan
   ([#2762](https://github.com/open-telemetry/opentelemetry-python/pull/2762))
+- Add `opentelemetry.propagate` module and `opentelemetry.propagators` package
+  to the API reference documentation
+  ([#2785](https://github.com/open-telemetry/opentelemetry-python/pull/2785))
 
 
 ## [1.12.0rc1-0.31b0](https://github.com/open-telemetry/opentelemetry-python/releases/tag/v1.12.0rc1-0.31b0) - 2022-05-17

docs/api/index.rst

@@ -8,6 +8,8 @@ OpenTelemetry Python API
 
     baggage
     context
+    propagate
+    propagators
     trace
     metrics
     environment_variables

docs/api/propagate.rst

@@ -0,0 +1,7 @@
+opentelemetry.propagate package
+========================================
+
+Module contents
+---------------
+
+.. automodule:: opentelemetry.propagate

docs/api/propagators.composite.rst

@@ -0,0 +1,7 @@
+opentelemetry.propagators.composite
+====================================================
+
+Module contents
+---------------
+
+.. automodule:: opentelemetry.propagators.composite

docs/api/propagators.rst

@@ -0,0 +1,10 @@
+opentelemetry.propagators package
+========================================
+
+Subpackages
+-----------
+
+.. toctree::
+
+   propagators.textmap
+   propagators.composite

docs/api/propagators.textmap.rst

@@ -0,0 +1,7 @@
+opentelemetry.propagators.textmap
+====================================================
+
+Module contents
+---------------
+
+.. automodule:: opentelemetry.propagators.textmap

docs/conf.py

@@ -97,6 +97,9 @@
 # https://github.com/sphinx-doc/sphinx/pull/3744
 nitpick_ignore = [
     ("py:class", "ValueT"),
+    ("py:class", "CarrierT"),
+    ("py:obj", "opentelemetry.propagators.textmap.CarrierT"),
+    ("py:obj", "Union"),
     (
         "py:class",
         "opentelemetry.sdk.metrics._internal.instrument._Synchronous",
@@ -112,23 +115,6 @@
         "py:class",
         "opentelemetry.trace._LinkBase",
     ),
-    # TODO: Understand why sphinx is not able to find this local class
-    (
-        "py:class",
-        "opentelemetry.propagators.textmap.TextMapPropagator",
-    ),
-    (
-        "py:class",
-        "opentelemetry.propagators.textmap.DefaultGetter",
-    ),
-    (
-        "any",
-        "opentelemetry.propagators.textmap.TextMapPropagator.extract",
-    ),
-    (
-        "any",
-        "opentelemetry.propagators.textmap.TextMapPropagator.inject",
-    ),
 ]
 
 # Add any paths that contain templates here, relative to this directory.