address review

Author: tybug

hypothesis-python/docs/reference/internals.rst

@@ -12,6 +12,10 @@ Hypothesis internals
 Alternative backends
 --------------------
 
+.. seealso::
+
+    See also the user-facing :ref:`alternative-backends` documentation.
+
 .. autoclass:: hypothesis.internal.conjecture.providers.PrimitiveProvider
     :members:
 

hypothesis-python/src/hypothesis/internal/conjecture/providers.py

@@ -101,7 +101,9 @@
 #: Though, as ``backend="hypothesis"`` is the default setting, the above would
 #: typically not have any effect.
 #:
-#: See also :ref:`alternative-backends`.
+#: The purpose of mapping to an absolute importable path, rather than the actual
+#: |PrimitiveProvider| class, is to avoid slowing down Hypothesis startup times
+#: by only importing alternative backends when required.
 AVAILABLE_PROVIDERS = {
     "hypothesis": "hypothesis.internal.conjecture.providers.HypothesisProvider",
     "hypothesis-urandom": "hypothesis.internal.conjecture.providers.URandomProvider",
@@ -448,9 +450,9 @@ def draw_string(
         intervals : IntervalSet
             The set of codepoints to sample from.
         min_size : int
-            (inclusive) lower bound on the string length.
+            (Inclusive) lower bound on the string length.
         max_size : int
-            (inclusive) upper bound on the string length.
+            (Inclusive) upper bound on the string length.
         """
         raise NotImplementedError
 
@@ -466,9 +468,9 @@ def draw_bytes(
         Parameters
         ----------
         min_size : int
-            (inclusive) lower bound on the bytes length.
+            (Inclusive) lower bound on the bytes length.
         max_size : int
-            (inclusive) upper bound on the bytes length.
+            (Inclusive) upper bound on the bytes length.
         """
         raise NotImplementedError
 

hypothesis-python/src/hypothesis/internal/observability.py

@@ -132,8 +132,9 @@ def _system_metadata():
 
 #: If ``False``, do not collect coverage information when observability is enabled.
 #:
-#: This is exposed for performance, as coverage collection can be slow on Python
-#: 3.11 and earlier. On Python 3.12+, there should be no need to set this.
+#: This is exposed both for performance (as coverage collection can be slow on
+#: Python 3.11 and earlier) and size (if you do not use coverage information,
+#: you may not want to store it in-memory).
 OBSERVABILITY_COLLECT_COVERAGE = (
     "HYPOTHESIS_EXPERIMENTAL_OBSERVABILITY_NOCOVER" not in os.environ
 )