diff --git a/python/helpers/pydev/_pydevd_bundle/pydevd_thrift.py b/python/helpers/pydev/_pydevd_bundle/pydevd_thrift.py
index 4f272b36c03a..aeb7a21f004f 100644
--- a/python/helpers/pydev/_pydevd_bundle/pydevd_thrift.py
+++ b/python/helpers/pydev/_pydevd_bundle/pydevd_thrift.py
@@ -1,3 +1,9 @@
+"""Contains methods for building Thrift structures for interacting with IDE
+
+The methods from this file are used for Python console interaction. Please
+note that the debugger still uses XML structures with the similar methods
+contained in `pydevd_xml.py` file.
+"""
 import sys
 import traceback
 
diff --git a/python/helpers/pydev/_pydevd_bundle/pydevd_xml.py b/python/helpers/pydev/_pydevd_bundle/pydevd_xml.py
index cf68f0282d8a..3b838c20f21b 100644
--- a/python/helpers/pydev/_pydevd_bundle/pydevd_xml.py
+++ b/python/helpers/pydev/_pydevd_bundle/pydevd_xml.py
@@ -1,3 +1,9 @@
+"""Contains methods for building XML structures for interacting with IDE
+
+The methods from this file are used for the debugger interaction. Please note
+that Python console now uses Thrift structures with the similar methods
+contained in `pydevd_thrift.py` file.
+"""
 from _pydev_bundle import pydev_log
 import traceback
 from _pydevd_bundle import pydevd_extension_utils