made HTML id/class names less confusing, added more documentation to all files