diff --git a/README.md b/README.md
index 53e3b190..5b5b4f6e 100644
--- a/README.md
+++ b/README.md
@@ -263,7 +263,8 @@ Maximum line length of source file.
 
 ## Syntax
 
-**TODO**: Update documentation.
+JavaScript and TypeScript sources are parsed according to their respective language specifications, thus limiting the
+kind of docblock comments that can be parsed. Efforts are being made to make this plugin language-agnostic, however.
 
 ## Syntax tree