2 files changed, 14 insertions, 0 deletions
diff --git a/docs/syntax/index.md b/docs/syntax/index.md
index 9398f6b..fa47202 100644
--- a/docs/syntax/index.md
+++ b/docs/syntax/index.md
@@ -82,6 +82,18 @@ Represented as an symbol or a keyword starting with \`
 1 `add 2
 ```
 
+## Operator Conventions
+
+```text
+`operator FIRST
+
+FIRST `operator SECOND
+
+FIRST `operator (REST; ...)
+
+`operator (FIRST; REST; ...)
+```
+
 # Symbols
 
 Start with a `.`
diff --git a/docs/syntax/operators.md b/docs/syntax/operators.md
index 33334b2..15241df 100644
--- a/docs/syntax/operators.md
+++ b/docs/syntax/operators.md
@@ -52,6 +52,8 @@ GREY
 WHITE
 ```
 
+`#NAME#NAME#` use single `#` to apply multiple colors at once
+
 ## ``panic`
 
 Stops execution and prints `Any` to `stdout`