1 files changed, 8 insertions, 0 deletions
diff --git a/README.md b/README.md
index 19f4c9c..6bc005f 100644
--- a/README.md
+++ b/README.md
@@ -198,6 +198,14 @@ Example configuration for bootstrapping on NixOS (hashes may vary):
 }
 ~~~
 
+## Musl Performance Issues
+
+Musl has huge allocator contention issues with multithreading. For that reason,
+all our `musl` compilers are shipped with the alternative allocator
+[mimalloc](https://github.com/microsoft/mimalloc) that solves these issues. If
+you notice any performance slowdowns with your Musl-linked binaries, consider
+using the alternative allocator by appending `-l:mimalloc.o` to your `LDFLAGS`.
+
 ## License
 
 All files are copyright Huawei Cloud Computing Technology Co., Ltd., license