diff --git a/docs/layers/lang/python.md b/docs/layers/lang/python.md
index 9cd8d05fa..96874424d 100644
--- a/docs/layers/lang/python.md
+++ b/docs/layers/lang/python.md
@@ -131,6 +131,15 @@ is disabled, because it is too slow. To enable type info:
   enable_typeinfo = true
 ```
 
+By default, the python layer utilizes `neomake` for syntax checking, and the default python executable
+is simply `python`. Note that the python version is up to your system configuration. If the system
+(or environment) python version is 2, one can have the following configuration in the bootstrap function
+for syntax checking on python3:
+
+```vim
+let g:neomake_python_python_exe = 'python3'
+```
+
 ## Key bindings
 
 ### Jump to definition