added some xml documentation
made some suggested fixes