From fec2fd0b0c2184ddc1c65eb2b1c684014e905d11 Mon Sep 17 00:00:00 2001
From: Daan Verstraten <daanverstraten@hotmail.com>
Date: Wed, 1 May 2024 13:01:34 +0200
Subject: [PATCH] Update invalid.md

---
 json/invalid.md | 154 +++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 153 insertions(+), 1 deletion(-)

diff --git a/json/invalid.md b/json/invalid.md
index aaa5bdc..e4a78ab 100644
--- a/json/invalid.md
+++ b/json/invalid.md
@@ -2,4 +2,156 @@
 
 `json.invalid`
 
-Something in the json structure is considered an invalid json structure. Usually around the reported error.
+When you encounter this error, it indicates that there is something wrong with the JSON structure. Below are some common mistakes that lead to invalid JSON and how to fix them.
+
+Common JSON Errors
+
+## 1. Missing Quotes Around Strings
+
+JSON requires that all strings are enclosed in double quotes. Missing quotes will lead to a parsing error.
+
+Example of invalid JSON:
+
+```jsonc
+{
+  name: John Doe
+}
+```
+
+Fix:
+
+```jsonc
+{
+  "name": "John Doe"
+}
+```
+
+## 2. Missing commas
+
+Trailing commas are not allowed in JSON. Having a comma after the last key-value pair in an object or the last element in an array will cause an error.
+
+Example of invalid JSON:
+
+```jsonc
+{
+    "name": "John Doe"
+    "age": 30,
+}
+```
+
+Fix:
+
+```jsonc
+{
+  "name": "John Doe",
+  "age": 30
+}
+```
+
+## 3. Trailing Commas
+
+Trailing commas are not allowed in JSON. Having a comma after the last key-value pair in an object or the last element in an array will cause an error.
+
+Example of invalid JSON:
+
+```jsonc
+{
+  "name": "John Doe",
+  "age": 30,
+}
+```
+
+Fix:
+
+```jsonc
+{
+  "name": "John Doe",
+  "age": 30
+}
+```
+
+## 4. Using Single Quotes
+
+JSON does not support single quotes for strings. Strings must be enclosed in double quotes.
+
+Example of invalid JSON:
+
+```jsonc
+{
+  'name': 'John Doe'
+}
+```
+
+Fix:
+
+```jsonc
+{
+  "name": "John Doe"
+}
+```
+
+## 5. Unescaped Characters
+
+Certain characters in strings need to be escaped, such as backslashes, double quotes within strings, and control characters like newlines.
+
+Example of invalid JSON:
+
+```jsonc
+{
+    "text": "He said, "Hello, World!""
+}
+```
+
+Fix:
+
+```jsonc
+{
+  "text": "He said, \"Hello, World!\""
+}
+```
+
+## 6. Incorrect Data Types
+
+JSON only supports specific data types: `string`, `number`, `object`, `array`, `true`, `false`, and `null`. Using unsupported data types like undefined or functions will result in an error.
+
+Example of invalid JSON:
+
+```jsonc
+{
+  "value": undefined
+}
+```
+
+Fix:
+
+```jsonc
+{
+  "value": null
+}
+```
+
+## 7. Nested Errors
+
+Errors can also occur in nested structures if any of the above issues are present at any level of the JSON.
+
+Example of invalid JSON:
+
+```jsonc
+{
+  "user": {
+    "name": "John Doe",
+    "details": { "age": 30, "gender": "male", } // <-- trailing comma
+  }
+}
+```
+
+Fix:
+
+```jsonc
+{
+  "user": {
+    "name": "John Doe",
+    "details": { "age": 30, "gender": "male" }
+  }
+}
+```