add docs for custom scales