added design docs and updated readme