docs: Add note to #3292

web/book/src/reference/stdlib/transforms/from.md

@@ -2,29 +2,32 @@
 
 Specifies a data source.
 
-```prql no-eval
-from table_reference
+```prql
+from artists
 ```
 
-Table names containing schemas, keywords, or special characters
-[need to be contained within backticks](../../syntax/keywords.md#quoting).
-`default_db.tablename` can be used if the table name matches a function from the
-standard library.
+To introduce an alias, use an assign expression:
 
 ```prql
-default_db.group
-take 1
+from e = employees
+select e.first_name
 ```
 
-## Examples
+Table names containing spaces or special characters
+[need to be contained within backticks](../../syntax/keywords.md#quoting):
 
 ```prql
-from employees
+from `artist tracks`
 ```
 
-To introduce an alias, use an assign expression:
+`default_db.tablename` can be used if the table name matches a function from the
+standard library.
+
+```admonish note
+We realize this is an awkward workaround. Track & 👍 [#3271](https://github.com/PRQL/prql/issues/3271) for resolving this.
+```
 
 ```prql
-from e = employees
-select e.first_name
+default_db.group  # in place of `from group`
+take 1
 ```

web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__from__0.snap

@@ -1,11 +1,9 @@
 ---
 source: web/book/tests/documentation/book.rs
-expression: "default_db.group\ntake 1\n"
+expression: "from artists\n"
 ---
 SELECT
   *
 FROM
-  "group"
-LIMIT
-  1
+  artists
 

web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__from__1.snap

@@ -0,0 +1,9 @@
+---
+source: web/book/tests/documentation/book.rs
+expression: "from e = employees\nselect e.first_name\n"
+---
+SELECT
+  first_name
+FROM
+  employees AS e
+

web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__from__2.snap

@@ -0,0 +1,9 @@
+---
+source: web/book/tests/documentation/book.rs
+expression: "from `artist tracks`\n"
+---
+SELECT
+  *
+FROM
+  "artist tracks"
+

web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__from__3.snap

@@ -0,0 +1,11 @@
+---
+source: web/book/tests/documentation/book.rs
+expression: "default_db.group  # in place of `from group`\ntake 1\n"
+---
+SELECT
+  *
+FROM
+  "group"
+LIMIT
+  1
+