In general, it would be nice to have some very basic math description of the method in the class description (of all classes)
But we will go through the doc at the end anyways