diff --git a/packages/typescript/tsconfig.json5 b/packages/typescript/tsconfig.json5
index 66243ea7..2400502c 100644
--- a/packages/typescript/tsconfig.json5
+++ b/packages/typescript/tsconfig.json5
@@ -1,3 +1,8 @@
+/**
+ * NOTES:
+ *  Although this file's extension is json5, it must follow jsonc syntax (tsc only read those)
+ */
+
 {
   "compilerOptions": {
     /* Basic Options */