diff --git a/docs/customization.md b/docs/customization.md
index b74d086957..8211e9120a 100644
--- a/docs/customization.md
+++ b/docs/customization.md
@@ -226,7 +226,8 @@ This is customized info
 [[tool.commitizen.customize.questions]]
 type = "list"
 name = "change_type"
-choices = ["feature", "bug fix"]
+choices = [{value = "feature", name = "feature: A new feature."}, {value = "bug fix", name = "bug fix: A bug fix."}]
+# choices = ["feature", "fix"]  # short version
 message = "Select the type of change you are committing"
 
 [[tool.commitizen.customize.questions]]
@@ -244,7 +245,7 @@ message = "Do you want to add body message in commit?"
 
 | Parameter          | Type   | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
 | ------------------ | ------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `question`         | `dict` | `None`  | Questions regarding the commit message. Detailed below.                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `questions`        | `dict` | `None`  | Questions regarding the commit message. Detailed below.                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `message_template` | `str`  | `None`  | The template for generating message from the given answers. `message_template` should either follow the [string.Template](https://docs.python.org/3/library/string.html#template-strings) or [Jinja2](https://jinja.palletsprojects.com/en/2.10.x/) formatting specification, and all the variables in this template should be defined in `name` in `questions`. Note that `Jinja2` is not installed by default. If not installed, commitizen will use `string.Template` formatting. |
 | `example`          | `str`  | `None`  | (OPTIONAL) Provide an example to help understand the style. Used by `cz example`.                                                                                                                                                                                                                                                                                                                                                                                                    |
 | `schema`           | `str`  | `None`  | (OPTIONAL) Show the schema used. Used by `cz schema`.                                                                                                                                                                                                                                                                                                                                                                                                                                |
@@ -253,13 +254,13 @@ message = "Do you want to add body message in commit?"
 | `bump_map`         | `dict` | `None`  | (OPTIONAL) Dictionary mapping the extracted information to a `SemVer` increment type (`MAJOR`, `MINOR`, `PATCH`)                                                                                                                                                                                                                                                                                                                                                                     |
 | `bump_pattern`     | `str`  | `None`  | (OPTIONAL) Regex to extract information from commit (subject and body)                                                                                                                                                                                                                                                                                                                                                                                                               |
 
-#### Detailed `question` content
+#### Detailed `questions` content
 
 | Parameter | Type   | Default | Description                                                                                                                                                                                                                  |
 | --------- | ------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `type`    | `str`  | `None`  | The type of questions. Valid type: `list`, `input` and etc. [See More](https://github.com/tmbo/questionary#different-question-types)                                                                                         |
 | `name`    | `str`  | `None`  | The key for the value answered by user. It's used in `message_template`                                                                                                                                                      |
 | `message` | `str`  | `None`  | Detail description for the question.                                                                                                                                                                                         |
-| `choices` | `list` | `None`  | (OPTIONAL) The choices when `type = choice`. It should be list of dictionaries with `name` and `value`. (e.g., `[{value = "feature", name = "feature: A new feature."}, {value = "bug fix", name = "bug fix: A bug fix."}]`) |
+| `choices` | `list` | `None`  | (OPTIONAL) The choices when `type = list`. Either use a list of values or a list of dicitionaries with `name` and `value` keys. See examples above. |
 | `default` | `Any`  | `None`  | (OPTIONAL) The default value for this question.                                                                                                                                                                              |
 | `filter`  | `str`  | `None`  | (Optional) Validator for user's answer. **(Work in Progress)**                                                                                                                                                               |