improving docs

uravu/_fig_params.py

@@ -1,13 +1,11 @@
 """
-Figure parameters for kinisi to help make nice plots.
-
-Copyright (c) Andrew R. McCluskey and Benjamin J. Morgan
-
-Distributed under the terms of the MIT License
-
-@author: Andrew R. McCluskey
+Figure parameters for uravu to help make nice plots.
 """
 
+# Copyright (c) Andrew R. McCluskey
+# Distributed under the terms of the MIT License
+# author: Andrew R. McCluskey
+
 from collections import OrderedDict
 from matplotlib import rcParams, cycler
 

uravu/plotting.py

@@ -1,5 +1,10 @@
 """
-Plotting functions
+These are plotting functions that take either :class:`Relationship`
+or :class:`Distribution` class objects. 
+
+The aim is to produce *publication quality* plots. However, we
+recognise that taste exists, and ours may be different from yours. 
+The colorscheme in this work was chosen to be colorblind friendly. 
 """
 
 # Copyright (c) Andrew R. McCluskey

uravu/sampling.py

@@ -1,10 +1,10 @@
 """
-This is the Relationship class, which allows for the storage and manipulation
-of analytical relationships between and abscissa and ordinate.
+The :mod:`sampling` module implements the use of a generalised 
+MCMC (using `emcee`_) and nested sampling (using `dynesty`_) for the 
+:class:`Relationship` objects. 
 
-This enables the determination of maximum likelihood, the evalulation of
-posterior probability distributions by Markov chain Monte-Carlo (MCMC) and
-the determination of Bayesian evidence using nested sampling.
+.. _emcee: https://emcee.readthedocs.io/
+.. _dynesty: https://dynesty.readthedocs.io/
 """
 
 # Copyright (c) Andrew R. McCluskey

uravu/utils.py

@@ -1,5 +1,6 @@
 """
-Some utility functions for the uravu package.
+A few additional utility functions to improve the usability of 
+``uravu``. 
 """
 
 # Copyright (c) Andrew R. McCluskey