Improvements to documentation

Can I document with disclaimer? It's an important functionality, and people can just scale to ~.8 instead of 1