diff --git a/README.md b/README.md
index cad624f..f77530d 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,11 @@ Most of the _G.d.ts file has been AI-generated from the official documentation,
 > TypeScript code converted to Lua code is not guaranteed to be correct or efficient.
 > Read the [TypeScriptToLua documentation](https://typescripttolua.github.io/docs/getting-started), follow best practices, and review the generated Lua code.
 
+> [!TIP]  
+> Several Picotron idiomatic functions can (and should) be used instead of their TypeScript counterparts.  
+> e.g. use `error()` instead of `throw new Error()`, or `deli()` instead of `array.splice()` to delete single items.
+> This will improve the performance and reduce the size of the generated Lua code.
+
 ## Setup
 
 ### Requirements