added more design docs
updated docs