Added a README file containing basic information about the simulator
along with a todo. I also cleaned up the directory and added some
comments in the api files.