Improve docs for style

Fixes #2273