diff --git a/doc/RTD/source/GettingStarted/compiling_code.rst b/doc/RTD/source/GettingStarted/compiling_code.rst
index dfad12360772fad728dcd05adc1532d0f578913b..6b5e8119ad7d7ebed7e676f5624a70d071c01281 100644
--- a/doc/RTD/source/GettingStarted/compiling_code.rst
+++ b/doc/RTD/source/GettingStarted/compiling_code.rst
@@ -23,6 +23,10 @@ We have specific issues with the following compilers:
 
 + GCC 7.3.0 with the -mskylake-avx512 flag.
 
+When using the clang compiler, the hand-written vectorized routines
+have to be disabled. This is done at configuration time by adding
+the flag `--disable-hand-vec`.
+
 Dependencies
 ------------