Add docs

Author: igorlukanin

docs/pages/product/apis-integrations/recipes/cast-numerics.mdx

@@ -16,7 +16,7 @@ numeric measure:
 ```yaml
 cubes:
   - name: cube_with_big_numbers
-    sql: >
+    sql: |
       SELECT              123::BIGINT AS number UNION ALL
       SELECT 9007199254740991::BIGINT AS number UNION ALL
       SELECT 9999999999999999::BIGINT AS number

docs/pages/product/apis-integrations/recipes/sorting.mdx

@@ -29,7 +29,7 @@ Consider the following data model:
 ```yaml
 cubes:
   - name: sort_nulls
-    sql: >
+    sql: |
       SELECT 1234 AS value UNION ALL
       SELECT 5678 AS value UNION ALL
       SELECT NULL AS value

docs/pages/product/caching/recipes/incrementally-building-pre-aggregations-for-a-date-range.mdx

@@ -21,7 +21,7 @@ Let's use an example of a cube with a nested SQL query:
 ```yaml
 cubes:
   - name: users_with_organizations
-    sql: >
+    sql: |
       WITH users AS (
         SELECT
           md5(company) AS organization_id,
@@ -168,7 +168,7 @@ properties][ref-schema-ref-preagg-buildrange]:
 ```yaml
 cubes:
   - name: users_with_organizations
-    sql: >
+    sql: |
       WITH users AS (
         SELECT
           md5(company) AS organization_id,

docs/pages/product/caching/recipes/refreshing-select-partitions.mdx

@@ -125,7 +125,7 @@ cubes:
         granularity: day
         partition_granularity: month # this is where we specify the partition
         refreshKey:
-          sql: >
+          sql: |
             SELECT max(updated_at) FROM public.orders WHERE
             {FILTER_PARAMS.orders.created_at.filter('created_at')}
 ```

docs/pages/product/configuration/recipes/custom-data-model-per-tenant.mdx

@@ -394,7 +394,7 @@ This is the `products` cube for the `avocado` tenant:
 ```yaml
 cubes:
   - name: products
-    sql: >
+    sql: |
       SELECT * FROM public.Products WHERE MOD (id, 2) = 1
 ```
 
@@ -417,7 +417,7 @@ This is the `products` cube for the `mango` tenant:
 ```yaml
 cubes:
   - name: products
-    sql: >
+    sql: |
       SELECT * FROM public.Products WHERE MOD (id, 2) = 0
 ```
 

docs/pages/product/configuration/reference/config.mdx

@@ -1082,7 +1082,7 @@ You can use the custom value from extend context in your data model like this:
 
 cubes:
   - name: users
-    sql: >
+    sql: |
       SELECT *
       FROM users
       WHERE organization_id={{ securityContext['active_organization'] }}

docs/pages/product/configuration/reference/environment-variables.mdx

@@ -1377,6 +1377,16 @@ See [this issue](https://github.com/cube-js/cube/issues/9285) for details.
 
 </ReferenceBox>
 
+## `CUBEJS_YAML_FOLDED_STRINGS_AS_LITERAL`
+
+If `true`, enables interpreting [folded strings][ref-yaml-folded-and-literal] in
+YAML-based data model files as literal strings. This affects how line breaks and spaces
+are handled in multi-line strings.
+
+| Possible Values | Default in Development | Default in Production |
+| --------------- | ---------------------- | --------------------- |
+| `true`, `false` | `true`                 | `true`                |
+
 ## `CUBEJS_WEB_SOCKETS`
 
 If `true`, then use WebSocket for data fetching.
@@ -1799,4 +1809,5 @@ The port for a Cube deployment to listen to API connections on.
 [ref-multi-stage-calculations]: /product/data-modeling/concepts/multi-stage-calculations
 [ref-folders]: /product/data-modeling/reference/view#folders
 [ref-dataviz-tools]: /product/configuration/visualization-tools
-[ref-context-to-app-id]: /product/configuration/reference/config#context_to_app_id
+[ref-context-to-app-id]: /product/configuration/reference/config#context_to_app_id
+[ref-yaml-folded-and-literal]: /product/data-modeling/dynamic/jinja#folded-and-literal-strings

docs/pages/product/data-modeling/concepts.mdx

@@ -85,7 +85,7 @@ cube(`orders`, {
 ```yaml
 cubes:
   - name: orders
-    sql: >
+    sql: |
       SELECT *
       FROM orders, line_items
       WHERE orders.id = line_items.order_id
@@ -564,7 +564,7 @@ Consider the following cube:
 ```yaml
 cubes:
   - name: employees
-    sql: >
+    sql: |
       SELECT 1 AS id, 'Ali' AS first_name, 20 AS age, 'Los Gatos' AS city UNION ALL
       SELECT 2 AS id, 'Bob' AS first_name, 30 AS age, 'San Diego' AS city UNION ALL
       SELECT 3 AS id, 'Eve' AS first_name, 40 AS age, 'San Diego' AS city

docs/pages/product/data-modeling/concepts/calculated-members.mdx

@@ -27,7 +27,7 @@ integer value.
 ```yaml
 cubes:
   - name: orders
-    sql: >
+    sql: |
       SELECT 1 AS id, 'processing' AS status UNION ALL
       SELECT 2 AS id, 'completed'  AS status UNION ALL
       SELECT 3 AS id, 'completed'  AS status
@@ -177,7 +177,7 @@ between `orders` and `users`:
 ```yaml
 cubes:
   - name: orders
-    sql: >
+    sql: |
       SELECT 1 AS id, 1 AS user_id UNION ALL
       SELECT 2 AS id, 1 AS user_id UNION ALL
       SELECT 3 AS id, 2 AS user_id
@@ -202,7 +202,7 @@ cubes:
         relationship: one_to_many
 
   - name: users
-    sql: >
+    sql: |
       SELECT 1 AS id, 'Alice' AS name UNION ALL
       SELECT 2 AS id, 'Bob'   AS name
 
@@ -308,7 +308,7 @@ granularity. It can be one of the [default granularities][ref-default-granularit
 ```yaml
 cubes:
   - name: users
-    sql: >
+    sql: |
       SELECT '2025-01-01T00:00:00Z' AS created_at UNION ALL
       SELECT '2025-02-01T00:00:00Z' AS created_at UNION ALL
       SELECT '2025-03-01T00:00:00Z' AS created_at
@@ -416,7 +416,7 @@ relationship between `orders` and `users`:
 ```yaml
 cubes:
   - name: orders
-    sql: >
+    sql: |
       SELECT 1 AS id, 1 AS user_id UNION ALL
       SELECT 2 AS id, 1 AS user_id UNION ALL
       SELECT 3 AS id, 2 AS user_id
@@ -437,7 +437,7 @@ cubes:
         relationship: one_to_many
 
   - name: users
-    sql: >
+    sql: |
       SELECT 1 AS id, 'Alice' AS name UNION ALL
       SELECT 2 AS id, 'Bob'   AS name
 

docs/pages/product/data-modeling/concepts/code-reusability-extending-cubes.mdx

@@ -141,7 +141,7 @@ First, the `sql` parameter can be overridden in each child cube:
 ```yaml
 cubes:
   - name: product_purchases
-    sql: >
+    sql: |
       SELECT *
       FROM events
       WHERE {FILTER_PARAMS.product_purchases.timestamp.filter('time')}
@@ -172,7 +172,7 @@ in the SQL query:
 ```yaml
 cubes:
   - name: base_events
-    sql: >
+    sql: |
       SELECT *
       FROM events
       WHERE