Improve docs for style

Fixes #2273
Same as above.