More comprehensive documentation for #5428

- Include issue number in NEWS.md
- Added missing colons in error message
- More detailed explanation of balance options and what they do in the help text.