added some documentation. since we are publishing this thing... might as well let people know why