updated README, added entry re design docs