Improve variables names or/and add documentation

[maxspahn]

Variable names like 'm' do not hold much information and should be changed to dim.
Also, documentation is required, but should be added at a later stage.

example poor variables names

[maxspahn]

Starting to address this in #35