Docs and readability

Some minor changes for readability and documentation, hopefully will help any other new people figure out what is going on.  
fixed