updated documents to discuss design