diff --git a/docs/docs/developer/additional/troubleshooting.mdx b/docs/docs/developer/additional/troubleshooting.mdx
new file mode 100644
index 0000000000..1a4d215689
--- /dev/null
+++ b/docs/docs/developer/additional/troubleshooting.mdx
@@ -0,0 +1,22 @@
+---
+sidebar_position: 2
+sidebar_custom_props:
+  icon: TbExclamationCircle
+---
+
+# Troubleshooting
+
+
+## Windows setup eslint prettier error: `CR` line breaks found
+
+This is due to the linebreak characters of windows and the git configuration. Try running:
+```
+git config --global core.autocrlf false
+```
+
+Then delete the repository and clone it again.
+
+
+## Yarn lock file changed and new files are created (`yarn.lock`, `.yarnrc.yml`, `.yarn`)
+
+Maybe you are using yarn 3? Try installing [yarn classic](https://classic.yarnpkg.com/lang/en/)!
diff --git a/docs/src/theme/icons.js b/docs/src/theme/icons.js
index fcfbf6e81c..aafac9bf96 100644
--- a/docs/src/theme/icons.js
+++ b/docs/src/theme/icons.js
@@ -12,6 +12,7 @@ export {
   TbChecklist,
   TbCloud,
   TbDeviceDesktop,
+  TbExclamationCircle,
   TbEyeglass,
   TbFaceIdError,
   TbFolder,