Added dart doc and slight formating

Added some explanatory dart doc, should be ready to be ran through the dar doc generator. Made some slight style tweaks and added some suggestions as @todo items