add docs and move `--pattern` flag up to BaseGenerator