added notes about sw design