project documents

No serious changes. Just added state diagram and the design considerations