diff --git a/Troubleshooting.md b/Troubleshooting.md
new file mode 100644
index 0000000..27e9fc0
--- /dev/null
+++ b/Troubleshooting.md
@@ -0,0 +1,23 @@
+## Completion is not working
+
+1. Run the following code in your terminal:
+   ```zsh
+   for ZDOTFILE in /etc/(zsh/)#(z|.z)(shenv|profile|shrc|login)(N) ${ZDOTDIR:-${HOME}}/.z(shenv|profile|shrc|login)(N); do
+     if grep -Eq '^[^#]*compinit' ${ZDOTFILE}; then
+       print -u2 -P "%F{yellow}! You seem to be already calling %Bcompinit%b in %B${ZDOTFILE}%b.%f"
+     fi
+   done
+   ```
+
+2. If there's any output, you can either:
+   * Remove or disable the `compinit` call from each of the mentioned files:
+     * If you can edit the mentioned file, remove or comment the lines similar to these:
+       ```
+       autoload -Uz compinit
+       compinit
+       ```
+     * If the mentioned file is read-only, read it and look for specific instructions on how the `compinit` call should be disabled.
+   * Or remove the `completion` module:
+     1. Remove or comment the `zmodule completion` line from your `~/.zimrc` file.
+     2. Run `zimfw build` in your command prompt.
+     3. Restart your terminal.