Merge pull request #1242 from etimberg/fix/documentation

Updated some docs + minor improvement to category scale