Bettering the code documentation

[Pacmens]

When coming back to this project, I often had to ask myself why something was done a certain way. On some instances I still can't fully comprehend the underlying processes. This incomprehention goes so far that there is still points where I'm not sure why our code even works.

The goal here is to add adequate documentation to as many of those places as possible.

The primary method of this will be comments, but there may be some other means to employ