Add an example for the variant generator and specify FQCNs used

Q  | A
----|----
Doc fix? | yes
New docs? | yes
Fixed tickets | 

- Provide an explicit example, with details of options and variants generated.
- Improve descriptions.
- Add use statement for `VariantGenerator` to code block.
- Define FQCN for `VariantGeneratorInterface`