Cf. #454: Comments about vim-polyglot

README.md

@@ -92,6 +92,11 @@ The following are some alternative LaTeX plugins for Vim:
     removed because it adds a lot of complexity for relatively little gain
     (IMHO).
 
+    Note: LaTeX-Box is included with
+    [vim-polyglot](https://github.com/sheerun/vim-polyglot). Some users are not
+    quite aware of this and end up trying vimtex with LaTeX-Box enabled. This
+    will not work --- please disable LaTeX-Box first!
+
 - [LaTeX-Suite](http://vim-latex.sourceforge.net)
 
     The main difference between vimtex and LaTeX-Suite (aka vim-latex) is

doc/vimtex.txt

@@ -1946,6 +1946,16 @@ are a few things that must be considered for system interoperability. A number
 of common problems and suggested solutions are included in the following
 troubleshooting section.
 
+Problem: The user wants to use vim-polyglot~
+
+This is a problem, because vim-polyglot [0] includes and enables LaTeX-Box by
+default. LaTeX-Box will not work well with vimtex, e.g. because of conflicting
+mappings.
+
+Suggested solution: Don't use vim-polyglot.
+
+[0]: https://github.com/sheerun/vim-polyglot
+
 Problem: Upon starting continuous compilation the status bar indicates~
    'latexmk compile: started continuous mode' but compilation never terminates~
    and the quickfix window does not load.~