WIP messages: general refactoring, fixes and improvements

- [ ] missing empty line between first line and long description
- [ ] `@param` -> `:param`