Maintain the maths closer to the code

We probably want to keep the maths of closer to the implementation and at one and only one place.

We could do something ala scipy, with the maths written in docs of ReStructuredText files and use Sphinx to have documents?