diff --git a/makefiles/lint/doc8/include.mk b/makefiles/lint/doc8/include.mk
index 564fca9..8d784d4 100644
--- a/makefiles/lint/doc8/include.mk
+++ b/makefiles/lint/doc8/include.mk
@@ -14,6 +14,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # -----------------------------------------------------------------------
+# NOTE: The doc8 command runs recursively on directories so targets
+#       *-mod and *-src are not yet supported.
+# -----------------------------------------------------------------------
 
 ##--------------------##
 ##---]  INCLUDES  [---##