Improve docstrings

firecrown/likelihood/gaussian.py

@@ -13,12 +13,19 @@
 class ConstGaussian(GaussFamily):
     """A Gaussian log-likelihood with a constant covariance matrix."""
 
-    def compute_loglike(self, tools: ModelingTools):
-        """Compute the log-likelihood."""
+    def compute_loglike(self, tools: ModelingTools) -> float:
+        """Compute the log-likelihood.
+
+        :params tools: The modeling tools used to compute the likelihood.
+        :return: The log-likelihood.
+        """
         return -0.5 * self.compute_chisq(tools)
 
     def make_realization_vector(self) -> np.ndarray:
-        """Create a new realization of the model."""
+        """Create a new (randomized) realization of the model.
+
+        :return: A new realization of the model
+        """
         theory_vector = self.get_theory_vector()
         assert self.cholesky is not None
         new_data_vector = theory_vector + np.dot(