improved doc and violation msg formatting