Add notes about architecture decisions