[no-ci] Some docstrings

Author: han-ol

bayesflow/approximators/point_approximator.py

@@ -12,8 +12,10 @@
 @serializable(package="bayesflow.approximators")
 class PointApproximator(ContinuousApproximator):
     """
-    Defines a workflow for performing fast posterior or likelihood inference.
-    The distribution is approximated by point estimators with a feed-forward network and an optional summary network.
+    A workflow for fast amortized point estimation of a conditional distribution.
+
+    The distribution is approximated by point estimators, parameterized by a feed-forward `PointInferenceNetwork`.
+    Conditions can be compressed by an optional `SummaryNetwork` or used directly as input to the inference network.
     """
 
     def estimate(

bayesflow/links/ordered.py

@@ -6,6 +6,8 @@
 
 @serializable(package="links.ordered")
 class Ordered(keras.Layer):
+    """Activation function to link to a tensor which is monotonously increasing along a specified axis."""
+
     def __init__(self, axis: int, anchor_index: int, **kwargs):
         super().__init__(**keras_kwargs(kwargs))
         self.axis = axis

bayesflow/links/positive_semi_definite.py

@@ -4,6 +4,8 @@
 
 
 class PositiveSemiDefinite(keras.Layer):
+    """Activation function to link from any square matrix to a positive semidefinite matrix."""
+
     def __init__(self, **kwargs):
         super().__init__(**keras_kwargs(kwargs))