Enhancement Report: Improve commenting of code and docs

[Moosems]

Enhancement report:

Comments shouldn't be used to explain what a line is doing, but what the purpose of the code is. Better commenting is absolutely critical for writing good docs and getting help from others and that's something I also want to set a good example for.

My docs are kinda good but they don't outline everything as good as they should. Class init arguments should be mentioned for sure.