docs: add encoding configuration

Author: adam-grant-hendry

docs/config.md

@@ -184,6 +184,14 @@ Default: `[]`
 
 Calls the hook scripts **after** bumping the version. [Read more][post_bump_hooks]
 
+### `encoding`
+
+Type: `str`
+
+Default: `utf-8`
+
+Sets the character encoding to be used when parsing commit messages. [Read more][encoding]
+
 ## Configuration file
 
 ### pyproject.toml or .cz.toml
@@ -357,3 +365,4 @@ setup(
 [customization]: customization.md
 [shortcuts]: customization.md#shortcut-keys
 [annotated-tags-vs-lightweight]: https://stackoverflow.com/a/11514139/2047185
+[encoding]: tutorials/writing_commits.md#writing-commits

docs/tutorials/writing_commits.md

@@ -23,6 +23,8 @@ Now to the important part, when writing commits, it's important to think about:
 You may think this is trivial, but it's not. It's important for the reader to
 understand what happened.
 
+Emojis may be added as well (e.g. see [cz-emoji][cz_emoji]), which requires the `utf-8`, or equivalent, character encoding to support unicode characters. By default, `commitizen` uses the `utf-8` character encoding, but a different encoding may be set through the `encoding` [configuration option][configuration].
+
 ### Recommendations
 
 - **Keep the message short**: Makes the list of commits more readable (~50 chars).
@@ -40,3 +42,5 @@ understand what happened.
 
 [customization]: ../customization.md
 [conventional_commits]: https://www.conventionalcommits.org
+[cz_emoji]: https://commitizen-tools.github.io/commitizen/third-party-commitizen/#cz-emoji
+[configuration]: ../config.md#encoding