diff --git a/docs/source/Mux.rst b/docs/source/Mux.rst
index dee6b66b709485954f831c6673ef1a2c94afde8f..9d59c1626cfa50e2467eed5bf3f1426ed7d01112 100644
--- a/docs/source/Mux.rst
+++ b/docs/source/Mux.rst
@@ -131,6 +131,15 @@ format):
     23          opt_CFLAGS: '-O2'
 
 
+.. warning:: On some architectures misbehaving versions of CYaml
+   Python library were reported and Avocado always fails with
+   ``unacceptable character #x0000: control characters are not
+   allowed``. To workaround this issue you need to either update
+   the PyYaml to the version which works properly, or you need
+   to remove the ``python2.7/site-packages/yaml/cyaml.py`` or
+   disable CYaml import in Avocado sources. For details check
+   out the `Github issue <https://github.com/avocado-framework/avocado/issues/1190>`_
+
 There are couple of key=>value pairs (lines 4,6,8,11,13,...) and there are
 named nodes which define scope (lines 1,2,3,5,7,9,...). There are also additional
 flags (lines 2, 9, 14, 19) which modifies the behavior.