document how smart commits works