diff --git a/HACKING.md b/HACKING.md
index 645e1adb..b6e7d07a 100644
--- a/HACKING.md
+++ b/HACKING.md
@@ -72,3 +72,14 @@ make a copy of one of the sample scripts and rename it. Then run this command:
 ``` shell
 sudo systemctl enable voice-recognizer.service
 ```
+
+## Troubleshooting
+
+If you see an error like:
+
+``` shell
+ALSA lib pcm.c:8403:(snd_pcm_set_params) Rate doesn't match (requested 16000Hz, get 48000Hz)
+```
+
+Try deleting `~/.asoundrc`. If it happens repeatedly, please let us know on
+[this GitHub issue](https://github.com/google/aiyprojects-raspbian/issues/183).