update to doco re: scale