Update scales documentation and fix issue 8 (https://github.com/seancarmody/rmapaus/issues/8)