more improvements from reviews

Author: Marcinthecloud

src/content/docs/r2-sql/reference/limitations-best-practices.mdx

@@ -33,7 +33,7 @@ R2 SQL is designed for querying **partitioned** Apache Iceberg tables in your R2
 
 ## Supported SQL Clauses
 
-R2 SQL supports a limited set of SQL clauses: `SELECT`, `FROM`, `WHERE`, `ORDER BY`, and `LIMIT`. All other SQL clauses are not supported at the moment. New features will be released in the future, keep an eye on this page and the changelog\[LINK TO CHANGE LOG\] for the latest.
+R2 SQL supports a limited set of SQL clauses: `SELECT`, `FROM`, `WHERE`, `ORDER BY`, and `LIMIT`. All other SQL clauses are not supported at the moment. New features will be released in the future, keep an eye on this page for the latest.
 
 ---
 
@@ -56,14 +56,14 @@ R2 SQL supports a limited set of SQL clauses: `SELECT`, `FROM`, `WHERE`, `ORDER
 
 ```sql
 -- Valid
-SELECT timestamp, user_id, status
-SELECT *
+SELECT timestamp, user_id, status FROM my_table;
+SELECT * FROM my_table;
 
 -- Invalid
-SELECT user_id AS uid, timestamp AS ts
-SELECT COUNT(*) FROM events
-SELECT json_field.property FROM table
-SELECT 1 AS synthetic_column
+SELECT user_id AS uid, timestamp AS ts FROM my_table;
+SELECT COUNT(*) FROM events FROM FROM my_table;
+SELECT json_field.property FROM my_table;
+SELECT 1 AS synthetic_column FROM my_table;
 ```
 
 ---
@@ -128,7 +128,6 @@ SELECT * FROM logs WHERE status = 200 AND user_type = 'premium'
 SELECT * FROM requests WHERE (method = 'GET' OR method = 'POST') AND response_time < 1000
 
 --Invalid
-SELECT * FROM events -- Missing time filter
 SELECT * FROM logs WHERE tags[0] = 'error' -- Array filtering
 SELECT * FROM requests WHERE metadata.user_id = '123' -- JSON field filtering
 SELECT * FROM events WHERE col_a = col_b -- Column comparison
@@ -141,8 +140,8 @@ SELECT * FROM logs WHERE response_time + latency > 5000 -- Arithmetic
 
 ### Supported Features
 
-- **ASC**: Ascending order (Default)
-- **DESC**: Descending order
+- **ASC**: Ascending order
+- **DESC**: Descending order (Default, on full partition key)
 
 ### Limitations
 
@@ -153,7 +152,6 @@ SELECT * FROM logs WHERE response_time + latency > 5000 -- Arithmetic
 ```sql
 SELECT * FROM table_name WHERE ... ORDER BY partitionKey
 SELECT * FROM table_name WHERE ... ORDER BY partitionKey DESC
-SELECT * FROM table_name WHERE ... ORDER BY partitionKey DESC
 ```
 
 ---
@@ -175,7 +173,7 @@ SELECT * FROM table_name WHERE ... ORDER BY partitionKey DESC
 
 ```sql
 -- Valid
-SELECT * FROM events WHERE ... LIMIT 100
+SELECT * FROM events LIMIT 100
 SELECT * FROM logs WHERE ... LIMIT 10000
 
 -- Invalid

src/content/docs/r2-sql/reference/sql-reference.mdx

@@ -64,11 +64,6 @@ SELECT timestamp, user_id, response_code FROM table_name
 SELECT * FROM table_name
 ```
 
-### Examples
-
-```sql
-SELECT column_name FROM table_name
-```
 
 ---
 
@@ -89,14 +84,14 @@ SELECT * WHERE condition [AND|OR condition ...]
 
 #### Value Comparisons
 
-- `column_name BETWEEN value AND value`
+- `column_name BETWEEN value' AND 'value`
 - `column_name = value`
 - `column_name >= value`
 - `column_name > value`
 - `column_name <= value`
 - `column_name < value`
 - `column_name != value`
-- `column_name LIKE value%`
+- `column_name LIKE 'value%'`
 
 #### Logical Operators
 
@@ -109,6 +104,8 @@ SELECT * WHERE condition [AND|OR condition ...]
 - **float** \- Decimal numbers
 - **string** \- Text values (quoted)
 - **timestamp** - RFC3339 format (`'YYYY-DD-MMT-HH:MM:SSZ'`)
+- **date** - Date32/Data64 expressed as a string (`'YYYY-MM-DD'`)
+- **boolean** - Explicitly valued (true, false)
 
 ### Examples
 
@@ -247,7 +244,7 @@ SELECT * FROM table_name WHERE country_code = 'US'
 
 ## Operator Precedence
 
-1. **Comparison operators**: `=`, `!=`, `<`, `<=`, `>`, `>=`, `LIK#`, `BETWEEN`, `IS NULL`, `IS NOT NULL`
+1. **Comparison operators**: `=`, `!=`, `<`, `<=`, `>`, `>=`, `LIKE`, `BETWEEN`, `IS NULL`, `IS NOT NULL`
 2. **AND** (higher precedence)
 3. **OR** (lower precedence)
 

src/content/docs/r2-sql/troubleshooting.mdx

@@ -14,7 +14,7 @@ This guide covers potential errors and limitations you may encounter when using
 ### Missing Required Clauses
 
 <div className="error-box">
-**Error**: `expected exactly 1 table in `FROM` clause`
+**Error**: `expected exactly 1 table in FROM clause`
 </div>
 
 **Problem**: R2 SQL requires specific clauses in your query.
@@ -75,7 +75,7 @@ SELECT json_field FROM logs
 ### Synthetic Data
 
 <div className="error-box">
-**Error**: `aliases (`AS`) are not supported`
+**Error**: `aliases (AS) are not supported`
 </div>
 
 **Problem**: Cannot create synthetic columns with literal values.
@@ -120,7 +120,7 @@ SELECT * FROM table2 WHERE id IN ('id1', 'id2', 'id3')
 ### Subqueries
 
 <div className="error-box">
-**Error**: `only table name is supported in `FROM` clause`
+**Error**: `only table name is supported in FROM clause`
 </div>
 
 **Problem**: Cannot use subqueries in FROM clause.