imporved code commentary
commiting my changes. fixed a bunch of annoyances
still merging