docs: added design desicions