diff --git a/doc/tutorials/introduction/documenting_opencv/documentation_tutorial.markdown b/doc/tutorials/introduction/documenting_opencv/documentation_tutorial.markdown
index 96d39b41da..6b9a14b0ab 100644
--- a/doc/tutorials/introduction/documenting_opencv/documentation_tutorial.markdown
+++ b/doc/tutorials/introduction/documenting_opencv/documentation_tutorial.markdown
@@ -51,6 +51,9 @@ Generate documentation {#tutorial_documentation_generate}
     @code{.sh}
     make check_pylint
     @endcode
+@note [Pylint](https://www.pylint.org/#install) must be installed before running cmake to be
+able to test Python code. You can install using your system's package manager, or with pip:
+@code{.sh} pip install pylint @endcode
 
 Quick start {#tutorial_documentation_quick_start}
 ===========