debugging documentation added
near final finishing the read me file, but now need links