These two parameters are just shortcuts for the actual parameters (tags, roles). Removing them will keep consistent with methods (there isn't a method parameter), and users won't be confused with example and examples parameters (they are valid keys in OpenAPI3).

• Remove usage of these params in examples and docs
• Add deprecate warning in 1.0
• Remove them in 1.1