docs: prioritize examples and shorten notes

Author: gepser

README.md

@@ -20,43 +20,6 @@ So I decided to recreate it.
 > [!NOTE]
 > I'll try to keep this domain name up as much as possible, so wish me a long life 🙂
 
-## 📜 API Contract
-
-### Endpoint
-
-- `GET /progress/{percentage}`
-- `HEAD /progress/{percentage}`
-
-`percentage` can be an integer or float and is clamped to `0..100`.
-
-### Query params
-
-- `dangerColor`
-- `warningColor`
-- `successColor`
-- `barColor` (overrides the bar fill color)
-- `label` (custom text inside the bar, max 64 chars)
-- `min`
-- `max`
-
-All color values must be 6-character hex values without `#` (example: `ff9900`).
-`min` and `max` must be provided together when used.
-
-### Response behavior
-
-- `200 OK`: valid request, returns SVG.
-- `400 Bad Request`: invalid numeric input, range config, label length, or color format.
-- `405 Method Not Allowed`: any method different from `GET` or `HEAD`.
-- `500 Internal Server Error`: template parse/render failure.
-
-Headers for successful responses:
-
-- `Content-Type: image/svg+xml`
-- `Cache-Control: public, max-age=300`
-
-> [!TIP]
-> `percentage` values outside `0..100` are accepted and clamped automatically.
-
 ## ✨ Examples
 
 > [!TIP]
@@ -67,8 +30,6 @@ Headers for successful responses:
 ![](https://geps.dev/progress/10)
 
 > [!NOTE]
-> URL: `https://geps.dev/progress/10`  
-> Markdown:
 > ```md
 > ![](https://geps.dev/progress/10)
 > ```
@@ -78,8 +39,6 @@ Headers for successful responses:
 ![](https://geps.dev/progress/76.5)
 
 > [!NOTE]
-> URL: `https://geps.dev/progress/76.5`  
-> Markdown:
 > ```md
 > ![](https://geps.dev/progress/76.5)
 > ```
@@ -89,8 +48,6 @@ Headers for successful responses:
 ![](https://geps.dev/progress/150)
 
 > [!NOTE]
-> URL: `https://geps.dev/progress/150`  
-> Markdown:
 > ```md
 > ![](https://geps.dev/progress/150)
 > ```
@@ -100,8 +57,6 @@ Headers for successful responses:
 ![](https://geps.dev/progress/-10)
 
 > [!NOTE]
-> URL: `https://geps.dev/progress/-10`  
-> Markdown:
 > ```md
 > ![](https://geps.dev/progress/-10)
 > ```
@@ -113,8 +68,6 @@ Headers for successful responses:
 ![](https://geps.dev/progress/75?dangerColor=800000&warningColor=ff9900&successColor=006600)
 
 > [!NOTE]
-> URL pattern: `https://geps.dev/progress/{value}?dangerColor=800000&warningColor=ff9900&successColor=006600`  
-> Markdown:
 > ```md
 > ![](https://geps.dev/progress/50?dangerColor=800000&warningColor=ff9900&successColor=006600)
 > ```
@@ -124,8 +77,6 @@ Headers for successful responses:
 ![](https://geps.dev/progress/50?barColor=4472C4)
 
 > [!NOTE]
-> URL: `https://geps.dev/progress/50?barColor=4472C4`  
-> Markdown:
 > ```md
 > ![](https://geps.dev/progress/50?barColor=4472C4)
 > ```
@@ -135,8 +86,6 @@ Headers for successful responses:
 ![](https://geps.dev/progress/186?label=186&min=0&max=241&barColor=4472C4)
 
 > [!NOTE]
-> URL: `https://geps.dev/progress/186?label=186&min=0&max=241&barColor=4472C4`  
-> Markdown:
 > ```md
 > ![](https://geps.dev/progress/186?label=186&min=0&max=241&barColor=4472C4)
 > ```
@@ -146,8 +95,6 @@ Headers for successful responses:
 ![](https://geps.dev/progress/50?min=0&max=200)
 
 > [!NOTE]
-> URL: `https://geps.dev/progress/50?min=0&max=200`  
-> Markdown:
 > ```md
 > ![](https://geps.dev/progress/50?min=0&max=200)
 > ```
@@ -157,12 +104,47 @@ Headers for successful responses:
 ![](https://geps.dev/progress/70?label=Sprint%201)
 
 > [!NOTE]
-> URL: `https://geps.dev/progress/70?label=Sprint%201`  
-> Markdown:
 > ```md
 > ![](https://geps.dev/progress/70?label=Sprint%201)
 > ```
 
+## 📜 API Contract
+
+### Endpoint
+
+- `GET /progress/{percentage}`
+- `HEAD /progress/{percentage}`
+
+`percentage` can be an integer or float and is clamped to `0..100`.
+
+### Query params
+
+- `dangerColor`
+- `warningColor`
+- `successColor`
+- `barColor` (overrides the bar fill color)
+- `label` (custom text inside the bar, max 64 chars)
+- `min`
+- `max`
+
+All color values must be 6-character hex values without `#` (example: `ff9900`).
+`min` and `max` must be provided together when used.
+
+### Response behavior
+
+- `200 OK`: valid request, returns SVG.
+- `400 Bad Request`: invalid numeric input, range config, label length, or color format.
+- `405 Method Not Allowed`: any method different from `GET` or `HEAD`.
+- `500 Internal Server Error`: template parse/render failure.
+
+Headers for successful responses:
+
+- `Content-Type: image/svg+xml`
+- `Cache-Control: public, max-age=300`
+
+> [!TIP]
+> `percentage` values outside `0..100` are accepted and clamped automatically.
+
 ## 🛠️ Local Development
 
 ### Prerequisites