Unify and clean code style and docstring

.gitignore

@@ -23,5 +23,6 @@ __pycache__
 build
 docs/build
 docs/source/_build
+docs/source/build
 debug.py
-docs/source/reference/*
+docs/source/reference/release_notes.rst

alea/examples/gaussian_model.py

@@ -1,32 +1,54 @@
 from typing import Optional
 
-from scipy import stats
 import numpy as np
+from scipy import stats
 
 from alea.model import StatisticalModel
 
 
 class GaussianModel(StatisticalModel):
+    """
+    A model of a gaussian measurement, where the model has parameters mu and sigma.
+    For illustration, we show how required nominal parameters can be added
+    to the init sigma is fixed in this example.
+
+    :param parameter_definition: definition of the parameters of the model
+    :type parameter_definition: dict or list
+    """
+
     def __init__(
             self,
             parameter_definition: Optional[dict or list] = None,
             **kwargs,
         ):
-        """
-        Initialise a model of a gaussian measurement (hatmu),
-        where the model has parameters mu and sigma
-        For illustration, we show how required nominal parameters can be added to the init
-        sigma is fixed in this example.
-        """
+        """Initialise a gaussian model."""
         if parameter_definition is None:
             parameter_definition = ["mu", "sigma"]
         super().__init__(parameter_definition=parameter_definition, **kwargs)
 
     def _ll(self, mu=None, sigma=None):
+        """
+        Log-likelihood of the model.
+
+        :param mu: mean of the gaussian
+        :type mu: float
+        :param sigma: standard deviation of the gaussian
+        :type sigma: float
+        """
         hat_mu = self.data[0]['hat_mu'][0]
         return stats.norm.logpdf(x=hat_mu, loc=mu, scale=sigma)
 
     def _generate_data(self, mu=None, sigma=None):
+        """
+        Generate data from the model.
+
+        :param mu: mean of the gaussian
+        :type mu: float
+        :param sigma: standard deviation of the gaussian
+        :type sigma: float
+        :return: data generated from the model
+        :rtype: list
+        """
         hat_mu = stats.norm(loc=mu, scale=sigma).rvs()
         data = [np.array([(hat_mu,)], dtype=[('hat_mu', float)])]
         return data