diff --git a/yarp/extension.c b/yarp/extension.c
index a189b1a876..1044dc3d08 100644
--- a/yarp/extension.c
+++ b/yarp/extension.c
@@ -1,5 +1,8 @@
 #include "yarp/extension.h"
 
+// NOTE: this file should contain only bindings.
+// All non-trivial logic should be in librubyparser so it can be shared its the various callers.
+
 VALUE rb_cYARP;
 VALUE rb_cYARPSource;
 VALUE rb_cYARPToken;