adding links

rilldata · royendo · Aug 4, 2025 · Aug 4, 2025 · Aug 4, 2025 · Aug 4, 2025
commit 6ffe7f88f17df796e18be7fcac2f0630e73b6d6b
diff --git a/docs/docs/hidden/yaml/apis.md b/docs/docs/hidden/yaml/apis.md
@@ -26,7 +26,7 @@ _[object]_ - OpenAPI specification for the API endpoint
 
 ### `security`
 
-_[object]_ - Defines security rules and access control policies for resources 
+_[object]_ - Defines [security rules and access control policies](/manage/security) for resources 
 
   - **`access`** - _[oneOf]_ - Expression indicating if the user should be granted access to the dashboard. If not defined, it will resolve to false and the dashboard won't be accessible to anyone. Needs to be a valid SQL expression that evaluates to a boolean. 
 
@@ -162,22 +162,3 @@ _[object]_ - Based on resource status _(required)_
 resource_status:
   where_error: true
 ```
-
-
-## Common Properties
-
-### `name`
-
-_[string]_ - Name is usually inferred from the filename, but can be specified manually. 
-
-### `refs`
-
-_[array of string]_ - List of resource references 
-
-### `dev`
-
-_[object]_ - Overrides any properties in development environment. 
-
-### `prod`
-
-_[object]_ - Overrides any properties in production environment. 
diff --git a/docs/docs/hidden/yaml/canvas-dashboards.md b/docs/docs/hidden/yaml/canvas-dashboards.md
@@ -112,7 +112,7 @@ _[object]_ - Indicates if filters should be enabled for the canvas.
 
 ### `security`
 
-_[object]_ - Defines security rules and access control policies for dashboards (without row filtering) 
+_[object]_ - Defines [security rules and access control policies](/manage/security) for dashboards (without row filtering) 
 
   - **`access`** - _[oneOf]_ - Expression indicating if the user should be granted access to the dashboard. If not defined, it will resolve to false and the dashboard won't be accessible to anyone. Needs to be a valid SQL expression that evaluates to a boolean. 
 

diff --git a/docs/docs/hidden/yaml/explore-dashboards.md b/docs/docs/hidden/yaml/explore-dashboards.md
@@ -202,7 +202,7 @@ _[object]_ - Configuration options for embedded dashboard views
 
 ### `security`
 
-_[object]_ - Defines security rules and access control policies for dashboards (without row filtering) 
+_[object]_ - Defines [security rules and access control policies](/manage/security) for dashboards (without row filtering) 
 
   - **`access`** - _[oneOf]_ - Expression indicating if the user should be granted access to the dashboard. If not defined, it will resolve to false and the dashboard won't be accessible to anyone. Needs to be a valid SQL expression that evaluates to a boolean. 
 

diff --git a/docs/docs/hidden/yaml/metrics-views.md b/docs/docs/hidden/yaml/metrics-views.md
@@ -16,6 +16,10 @@ _[string]_ - The version of the metrics view schema
 
 _[string]_ - Refers to the resource type and must be `metrics_view` _(required)_
 
+### `connector`
+
+_[string]_ - Refers to the connector type for the metrics view, see [OLAP engines](/build/olap) for more information 
+
 ### `display_name`
 
 _[string]_ - Refers to the display name for the metrics view 
@@ -26,7 +30,7 @@ _[string]_ - Refers to the description for the metrics view
 
 ### `ai_instructions`
 
-_[string]_ - Extra instructions for AI agents. Used to guide natural language question answering and routing. 
+_[string]_ - Extra instructions for [AI agents](/explore/mcp). Used to guide natural language question answering and routing. 
 
 ### `model`
 
@@ -136,7 +140,7 @@ _[array of object]_ - Used to define the numeric aggregates of columns from your
 
         - **`time_grain`** - _[string]_ - Time grain for time-based dimensions. 
 
-  - **`requires`** - _[anyOf]_ - using an available measure or dimension in your metrics view to set a required parameter, cannot be used with simple measures 
+  - **`requires`** - _[anyOf]_ - using an available measure or dimension in your metrics view to set a required parameter, cannot be used with simple measures. See [referencing measures](/build/metrics-view/advanced-expressions/referencing) for more information. 
 
     - **option 1** - _[string]_ - Simple field name as a string.
 
@@ -212,7 +216,7 @@ _[array of object]_ - Used to define annotations that can be displayed on charts
 
 ### `security`
 
-_[object]_ - Defines security rules and access control policies for resources 
+_[object]_ - Defines [security rules and access control policies](/manage/security) for resources 
 
   - **`access`** - _[oneOf]_ - Expression indicating if the user should be granted access to the dashboard. If not defined, it will resolve to false and the dashboard won't be accessible to anyone. Needs to be a valid SQL expression that evaluates to a boolean. 
 

diff --git a/docs/docs/hidden/yaml/rillyaml.md b/docs/docs/hidden/yaml/rillyaml.md
@@ -26,7 +26,7 @@ _[object]_ - Optional feature flags. Can be specified as a map of feature names
 
 ### `ai_instructions`
 
-_[string]_ - Extra instructions for LLM/AI features. Used to guide natural language question answering and routing. 
+_[string]_ - Extra instructions for [AI agents](/explore/mcp). Used to guide natural language question answering and routing. 
 
 ## Configuring the default OLAP Engine
 
@@ -38,7 +38,7 @@ Please see our reference documentation on [OLAP Engines](/docs/reference/olap-en
 
 ### `olap_connector`
 
-_[string]_ - Specifies the default OLAP engine for the project. Defaults to duckdb if not set. 
+_[string]_ - Specifies the [default OLAP engine](/build/olap) for the project. Defaults to duckdb if not set. 
 
 ```yaml
 olap_connector: clickhouse

diff --git a/runtime/parser/schema/project.schema.yaml b/runtime/parser/schema/project.schema.yaml
@@ -421,6 +421,9 @@ oneOf:
             type: string
             const: metrics_view
             description: Refers to the resource type and must be `metrics_view`
+          connector:
+            type: string
+            description: Refers to the connector type for the metrics view, see [OLAP engines](/build/olap) for more information
           display_name:
             type: string
             description: Refers to the display name for the metrics view
@@ -429,7 +432,7 @@ oneOf:
             description: Refers to the description for the metrics view
           ai_instructions:
             type: string
-            description: Extra instructions for AI agents. Used to guide natural language question answering and routing.
+            description: Extra instructions for [AI agents](/explore/mcp). Used to guide natural language question answering and routing.
           model:
             type: string
             description: Refers to the model powering the dashboard (either model or table is required)
@@ -543,7 +546,7 @@ oneOf:
                   description: for per dimensions
                 requires:
                   $ref: '#/definitions/field_selectors_properties'
-                  description: using an available measure or dimension in your metrics view to set a required parameter, cannot be used with simple measures
+                  description: using an available measure or dimension in your metrics view to set a required parameter, cannot be used with simple measures. See [referencing measures](/build/metrics-view/advanced-expressions/referencing) for more information.
                 valid_percent_of_total:
                   type: boolean
                   description: a boolean indicating whether percent-of-total values should be rendered for this measure
@@ -1117,7 +1120,7 @@ oneOf:
         required:
           - type
       - $ref: '#/definitions/data_properties'
-      - $ref: '#/definitions/common_properties'
+      # - $ref: '#/definitions/common_properties'
 
   # Themes
   - title: Theme YAML
@@ -1176,7 +1179,7 @@ oneOf:
             description: Optional feature flags. Can be specified as a map of feature names to booleans.
           ai_instructions:
             type: string
-            description: Extra instructions for LLM/AI features. Used to guide natural language question answering and routing.
+            description: Extra instructions for [AI agents](/explore/mcp). Used to guide natural language question answering and routing.
       - title: Configuring the default OLAP Engine  
         description: |
           Rill allows you to specify the default OLAP engine to use in your project via `rill.yaml`.
@@ -1187,7 +1190,7 @@ oneOf:
         properties:
           olap_connector:
             type: string
-            description: Specifies the default OLAP engine for the project. Defaults to duckdb if not set.
+            description: Specifies the [default OLAP engine](/build/olap) for the project. Defaults to duckdb if not set.
             examples: 
             - olap_connector: clickhouse
       - title: Project-wide defaults
@@ -1592,7 +1595,7 @@ definitions:
         description: 'If true, allows the schedule to run in development mode.'
   security_policy_properties:
     type: object
-    description: Defines security rules and access control policies for resources
+    description: Defines [security rules and access control policies](/manage/security) for resources
     properties:
       access:
         oneOf:
@@ -1689,7 +1692,7 @@ definitions:
 
   dashboard_security_policy_properties:
     type: object
-    description: Defines security rules and access control policies for dashboards (without row filtering)
+    description: Defines [security rules and access control policies](/manage/security) for dashboards (without row filtering)
     properties:
       access:
         oneOf: