raise ScaleValueError instead of AttributeError for scale mismatches;
minor updates to docs