squash. the latest fixes

- add validation of allExcept (should be a <String[]>)
- remove required
- rename except to allExcept (according to #698)
- fix docs