[CB-3962] cleaned up plugin spec, conforming to editorial guidelines

major changes that make newly introduced content conform to the editorial style sheet