@genome-spy/core 0.50.0 → 0.50.2

package/dist/schema.json

@@ -853,7 +853,7 @@
       "additionalProperties": false,
       "properties": {
         "baseUrl": {
-          "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+          "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
           "type": "string"
         },
         "columns": {
@@ -875,11 +875,12 @@
           "type": "array"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
-          "$ref": "#/definitions/Data"
+          "$ref": "#/definitions/Data",
+          "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
         },
         "description": {
           "anyOf": [
@@ -893,10 +894,11 @@
               "type": "array"
             }
           ],
-          "description": "A description of the view. Multiple lines can be provided as an array."
+          "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
         "encoding": {
-          "$ref": "#/definitions/Encoding"
+          "$ref": "#/definitions/Encoding",
+          "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
         },
         "height": {
           "anyOf": [
@@ -914,21 +916,18 @@
               "type": "string"
             }
           ],
-          "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
         },
         "name": {
+          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
           "type": "string"
         },
-        "opacity": {
-          "$ref": "#/definitions/ViewOpacityDef",
-          "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
-        },
         "padding": {
           "$ref": "#/definitions/PaddingConfig",
-          "description": "Padding in pixels.\n\n**Default:* `0`"
+          "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
         },
         "params": {
-          "description": "Dynamic variables that parameterize a visualization.",
+          "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
           "items": {
             "$ref": "#/definitions/Parameter"
           },
@@ -936,6 +935,7 @@
         },
         "resolve": {
           "additionalProperties": false,
+          "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
           "properties": {
             "axis": {
               "additionalProperties": {
@@ -970,7 +970,7 @@
           "additionalProperties": {
             "$ref": "#/definitions/ViewSpec"
           },
-          "description": "Templates that can be reused within the view specification by importing them with the template key.",
+          "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
           "type": "object"
         },
         "title": {
@@ -981,9 +981,11 @@
             {
               "$ref": "#/definitions/Title"
             }
-          ]
+          ],
+          "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
         },
         "transform": {
+          "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
           "items": {
             "$ref": "#/definitions/TransformParams"
           },
@@ -1002,7 +1004,7 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
         },
         "viewportWidth": {
           "anyOf": [
@@ -1017,10 +1019,10 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
         },
         "visible": {
-          "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+          "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
           "type": "boolean"
         },
         "width": {
@@ -1039,7 +1041,7 @@
               "type": "string"
             }
           ],
-          "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
         }
       },
       "required": [
@@ -2917,15 +2919,16 @@
       "additionalProperties": false,
       "properties": {
         "baseUrl": {
-          "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+          "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
           "type": "string"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
-          "$ref": "#/definitions/Data"
+          "$ref": "#/definitions/Data",
+          "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
         },
         "description": {
           "anyOf": [
@@ -2939,10 +2942,11 @@
               "type": "array"
             }
           ],
-          "description": "A description of the view. Multiple lines can be provided as an array."
+          "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
         "encoding": {
-          "$ref": "#/definitions/Encoding"
+          "$ref": "#/definitions/Encoding",
+          "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
         },
         "hconcat": {
           "description": "Specifies views that will be concatenated horizontally.",
@@ -2974,21 +2978,18 @@
               "type": "string"
             }
           ],
-          "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
         },
         "name": {
+          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
           "type": "string"
         },
-        "opacity": {
-          "$ref": "#/definitions/ViewOpacityDef",
-          "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
-        },
         "padding": {
           "$ref": "#/definitions/PaddingConfig",
-          "description": "Padding in pixels.\n\n**Default:* `0`"
+          "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
         },
         "params": {
-          "description": "Dynamic variables that parameterize a visualization.",
+          "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
           "items": {
             "$ref": "#/definitions/Parameter"
           },
@@ -2996,6 +2997,7 @@
         },
         "resolve": {
           "additionalProperties": false,
+          "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
           "properties": {
             "axis": {
               "additionalProperties": {
@@ -3030,7 +3032,7 @@
           "additionalProperties": {
             "$ref": "#/definitions/ViewSpec"
           },
-          "description": "Templates that can be reused within the view specification by importing them with the template key.",
+          "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
           "type": "object"
         },
         "title": {
@@ -3041,9 +3043,11 @@
             {
               "$ref": "#/definitions/Title"
             }
-          ]
+          ],
+          "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
         },
         "transform": {
+          "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
           "items": {
             "$ref": "#/definitions/TransformParams"
           },
@@ -3062,7 +3066,7 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
         },
         "viewportWidth": {
           "anyOf": [
@@ -3077,10 +3081,10 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
         },
         "visible": {
-          "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+          "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
           "type": "boolean"
         },
         "width": {
@@ -3099,7 +3103,7 @@
               "type": "string"
             }
           ],
-          "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
         }
       },
       "required": [
@@ -3348,6 +3352,7 @@
       "additionalProperties": false,
       "properties": {
         "aggregateSamples": {
+          "description": "Specifies views that [aggregate](https://genomespy.app/docs/sample-collections/visualizing/#aggregation) multiple samples within the GenomeSpy App.",
           "items": {
             "anyOf": [
               {
@@ -3361,15 +3366,16 @@
           "type": "array"
         },
         "baseUrl": {
-          "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+          "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
           "type": "string"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
-          "$ref": "#/definitions/Data"
+          "$ref": "#/definitions/Data",
+          "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
         },
         "description": {
           "anyOf": [
@@ -3383,10 +3389,11 @@
               "type": "array"
             }
           ],
-          "description": "A description of the view. Multiple lines can be provided as an array."
+          "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
         "encoding": {
-          "$ref": "#/definitions/Encoding"
+          "$ref": "#/definitions/Encoding",
+          "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
         },
         "height": {
           "anyOf": [
@@ -3404,7 +3411,7 @@
               "type": "string"
             }
           ],
-          "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
         },
         "layer": {
           "items": {
@@ -3423,18 +3430,19 @@
           "type": "array"
         },
         "name": {
+          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
           "type": "string"
         },
         "opacity": {
           "$ref": "#/definitions/ViewOpacityDef",
-          "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
+          "description": "Opacity of the view and all its children. Allows implementing semantic zooming where the layers are faded in and out as the user zooms in and out.\n\nTODO: Write proper documentation with examples.\n\n**Default:** `1.0`"
         },
         "padding": {
           "$ref": "#/definitions/PaddingConfig",
-          "description": "Padding in pixels.\n\n**Default:* `0`"
+          "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
         },
         "params": {
-          "description": "Dynamic variables that parameterize a visualization.",
+          "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
           "items": {
             "$ref": "#/definitions/Parameter"
           },
@@ -3442,6 +3450,7 @@
         },
         "resolve": {
           "additionalProperties": false,
+          "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
           "properties": {
             "axis": {
               "additionalProperties": {
@@ -3472,7 +3481,7 @@
           "additionalProperties": {
             "$ref": "#/definitions/ViewSpec"
           },
-          "description": "Templates that can be reused within the view specification by importing them with the template key.",
+          "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
           "type": "object"
         },
         "title": {
@@ -3483,9 +3492,11 @@
             {
               "$ref": "#/definitions/Title"
             }
-          ]
+          ],
+          "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
         },
         "transform": {
+          "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
           "items": {
             "$ref": "#/definitions/TransformParams"
           },
@@ -3507,7 +3518,7 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
         },
         "viewportWidth": {
           "anyOf": [
@@ -3522,10 +3533,10 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
         },
         "visible": {
-          "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+          "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
           "type": "boolean"
         },
         "width": {
@@ -3544,7 +3555,7 @@
               "type": "string"
             }
           ],
-          "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
         }
       },
       "required": [
@@ -3725,7 +3736,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Color of the mark. Affects either `fill` or `stroke`, depending on the `filled` property."
         },
         "linkShape": {
           "anyOf": [
@@ -3749,7 +3761,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "The shape of the link path. Either `\"arc\"`, `\"diagonal\"`, `\"line\"`, or `\"dome\"`.\n\n**Default value:** `\"arc\"`"
+          "description": "The shape of the link path.\n\nThe `\"arc\"` shape draws a circular arc between the two points. The apex of the arc resides on the left side of the line that connects the two points. The `\"dome\"` shape draws a vertical or horizontal arc with a specific height. The primary positional channel determines the apex of the arc and the secondary determines the endpoint placement. The `\"diagonal\"` shape draws an \"S\"-shaped curve between the two points. The `\"line\"` shape draws a straight line between the two points. See an [example](#different-link-shapes-and-orientations) of the different shapes below.\n\n**Default value:** `\"arc\"`"
         },
         "maxChordLength": {
           "anyOf": [
@@ -3807,7 +3819,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Opacity of the mark. Affects `fillOpacity` or `strokeOpacity`, depending on the `filled` property."
         },
         "orient": {
           "anyOf": [
@@ -3834,7 +3847,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "The number of segments in the bézier curve. Affects the rendering quality and performance. Use a higher value for a smoother curve.\n\n**Default value:* `101`"
+          "description": "The number of segments in the bézier curve. Affects the rendering quality and performance. Use a higher value for a smoother curve.\n\n**Default value:** `101`"
         },
         "size": {
           "anyOf": [
@@ -3849,7 +3862,7 @@
         },
         "tooltip": {
           "$ref": "#/definitions/Tooltip",
-          "description": "Tooltip handler. If `null`, no tooltip is shown."
+          "description": "Tooltip handler. If `null`, no tooltip is shown. If string, specifies the [tooltip handler](https://genomespy.app/docs/api/#custom-tooltip-handlers) to use."
         },
         "type": {
           "const": "link",
@@ -3863,7 +3876,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Position on the x axis."
         },
         "x2": {
           "anyOf": [
@@ -3873,7 +3887,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "The secondary position on the x axis."
         },
         "xOffset": {
           "description": "Offsets of the `x` and `x2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
@@ -3887,7 +3902,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Position on the y axis."
         },
         "y2": {
           "anyOf": [
@@ -3897,7 +3913,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "The secondary position on the y axis."
         },
         "yOffset": {
           "description": "Offsets of the `y` and `y2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
@@ -4222,7 +4239,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Color of the mark. Affects either `fill` or `stroke`, depending on the `filled` property."
         },
         "fill": {
           "anyOf": [
@@ -4233,7 +4251,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "The fill color"
+          "description": "The fill color."
         },
         "fillGradientStrength": {
           "anyOf": [
@@ -4244,7 +4262,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "Gradient strength controls the amount of the gradient eye-candy effect in the fill color. Valid values are between 0 and 1.\n\n**Default value:** `0`"
+          "description": "Gradient strength controls the amount of the gradient eye-candy effect in the fill color. Valid values are between `0` and `1`.\n\n**Default value:** `0`"
         },
         "fillOpacity": {
           "anyOf": [
@@ -4255,7 +4273,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "The fill opacity. Value between [0, 1]."
+          "description": "The fill opacity. Value between `0` and `1`."
         },
         "filled": {
           "description": "Whether the `color` represents the `fill` color (`true`) or the `stroke` color (`false`).",
@@ -4299,7 +4317,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Opacity of the mark. Affects `fillOpacity` or `strokeOpacity`, depending on the `filled` property."
         },
         "semanticZoomFraction": {
           "anyOf": [
@@ -4313,8 +4332,15 @@
           "description": "TODO\n\n**Default value:** `0.02`"
         },
         "shape": {
-          "description": "One of `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, or `\"triangle-left\"`.\n\n**Default value:** `\"circle\"`",
-          "type": "string"
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "$ref": "#/definitions/ExprRef"
+            }
+          ],
+          "description": "One of `\"circle\"`, `\"square\"`, `\"cross\"`, `\"diamond\"`, `\"triangle-up\"`, `\"triangle-down\"`, `\"triangle-right\"`, `\"triangle-left\"`, `\"tick-up\"`, `\"tick-down\"`, `\"tick-right\"`, or `\"tick-left\"`\n\n**Default value:** `\"circle\"`"
         },
         "size": {
           "anyOf": [
@@ -4347,7 +4373,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "The stroke opacity. Value between [0, 1]."
+          "description": "The stroke opacity. Value between `0` and `1`."
         },
         "strokeWidth": {
           "anyOf": [
@@ -4362,7 +4388,7 @@
         },
         "tooltip": {
           "$ref": "#/definitions/Tooltip",
-          "description": "Tooltip handler. If `null`, no tooltip is shown."
+          "description": "Tooltip handler. If `null`, no tooltip is shown. If string, specifies the [tooltip handler](https://genomespy.app/docs/api/#custom-tooltip-handlers) to use."
         },
         "type": {
           "const": "point",
@@ -4376,7 +4402,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Position on the x axis."
         },
         "xOffset": {
           "description": "Offsets of the `x` and `x2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
@@ -4390,7 +4417,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Position on the y axis."
         },
         "yOffset": {
           "description": "Offsets of the `y` and `y2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
@@ -4809,7 +4837,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Color of the mark. Affects either `fill` or `stroke`, depending on the `filled` property."
         },
         "cornerRadius": {
           "anyOf": [
@@ -4875,7 +4904,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "The fill color"
+          "description": "The fill color."
         },
         "fillOpacity": {
           "anyOf": [
@@ -4886,7 +4915,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "The fill opacity. Value between [0, 1]."
+          "description": "The fill opacity. Value between `0` and `1`."
         },
         "filled": {
           "description": "Whether the `color` represents the `fill` color (`true`) or the `stroke` color (`false`).",
@@ -4937,7 +4966,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Opacity of the mark. Affects `fillOpacity` or `strokeOpacity`, depending on the `filled` property."
         },
         "stroke": {
           "anyOf": [
@@ -4959,7 +4989,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "The stroke opacity. Value between [0, 1]."
+          "description": "The stroke opacity. Value between `0` and `1`."
         },
         "strokeWidth": {
           "anyOf": [
@@ -4974,7 +5004,7 @@
         },
         "tooltip": {
           "$ref": "#/definitions/Tooltip",
-          "description": "Tooltip handler. If `null`, no tooltip is shown."
+          "description": "Tooltip handler. If `null`, no tooltip is shown. If string, specifies the [tooltip handler](https://genomespy.app/docs/api/#custom-tooltip-handlers) to use."
         },
         "type": {
           "const": "rect",
@@ -4988,7 +5018,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Position on the x axis."
         },
         "x2": {
           "anyOf": [
@@ -4998,7 +5029,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "The secondary position on the x axis."
         },
         "xOffset": {
           "description": "Offsets of the `x` and `x2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
@@ -5012,7 +5044,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Position on the y axis."
         },
         "y2": {
           "anyOf": [
@@ -5022,7 +5055,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "The secondary position on the y axis."
         },
         "yOffset": {
           "description": "Offsets of the `y` and `y2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
@@ -5148,6 +5182,7 @@
               "type": "string"
             },
             "aggregateSamples": {
+              "description": "Specifies views that [aggregate](https://genomespy.app/docs/sample-collections/visualizing/#aggregation) multiple samples within the GenomeSpy App.",
               "items": {
                 "anyOf": [
                   {
@@ -5165,15 +5200,16 @@
               "type": "string"
             },
             "baseUrl": {
-              "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+              "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
               "type": "string"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
-              "$ref": "#/definitions/Data"
+              "$ref": "#/definitions/Data",
+              "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
             },
             "datasets": {
               "additionalProperties": {
@@ -5195,10 +5231,11 @@
                   "type": "array"
                 }
               ],
-              "description": "A description of the view. Multiple lines can be provided as an array."
+              "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
             "encoding": {
-              "$ref": "#/definitions/Encoding"
+              "$ref": "#/definitions/Encoding",
+              "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
             },
             "genome": {
               "$ref": "#/definitions/GenomeConfig"
@@ -5219,7 +5256,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
             },
             "mark": {
               "anyOf": [
@@ -5229,21 +5266,23 @@
                 {
                   "$ref": "#/definitions/MarkProps"
                 }
-              ]
+              ],
+              "description": "The graphical mark presenting the data objects."
             },
             "name": {
+              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
               "type": "string"
             },
             "opacity": {
               "$ref": "#/definitions/ViewOpacityDef",
-              "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
+              "description": "Opacity of the view and all its children. Allows implementing semantic zooming where the layers are faded in and out as the user zooms in and out.\n\nTODO: Write proper documentation with examples.\n\n**Default:** `1.0`"
             },
             "padding": {
               "$ref": "#/definitions/PaddingConfig",
-              "description": "Padding in pixels.\n\n**Default:* `0`"
+              "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
             },
             "params": {
-              "description": "Dynamic variables that parameterize a visualization.",
+              "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
               "items": {
                 "$ref": "#/definitions/Parameter"
               },
@@ -5251,6 +5290,7 @@
             },
             "resolve": {
               "additionalProperties": false,
+              "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
               "properties": {
                 "axis": {
                   "additionalProperties": {
@@ -5281,7 +5321,7 @@
               "additionalProperties": {
                 "$ref": "#/definitions/ViewSpec"
               },
-              "description": "Templates that can be reused within the view specification by importing them with the template key.",
+              "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
               "type": "object"
             },
             "title": {
@@ -5292,16 +5332,19 @@
                 {
                   "$ref": "#/definitions/Title"
                 }
-              ]
+              ],
+              "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
             },
             "transform": {
+              "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
               "items": {
                 "$ref": "#/definitions/TransformParams"
               },
               "type": "array"
             },
             "view": {
-              "$ref": "#/definitions/ViewBackground"
+              "$ref": "#/definitions/ViewBackground",
+              "description": "The background of the view, including fill, stroke, and stroke width."
             },
             "viewportHeight": {
               "anyOf": [
@@ -5316,7 +5359,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
             },
             "viewportWidth": {
               "anyOf": [
@@ -5331,10 +5374,10 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
             },
             "visible": {
-              "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+              "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
               "type": "boolean"
             },
             "width": {
@@ -5353,7 +5396,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
             }
           },
           "required": [
@@ -5368,6 +5411,7 @@
               "type": "string"
             },
             "aggregateSamples": {
+              "description": "Specifies views that [aggregate](https://genomespy.app/docs/sample-collections/visualizing/#aggregation) multiple samples within the GenomeSpy App.",
               "items": {
                 "anyOf": [
                   {
@@ -5385,15 +5429,16 @@
               "type": "string"
             },
             "baseUrl": {
-              "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+              "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
               "type": "string"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
-              "$ref": "#/definitions/Data"
+              "$ref": "#/definitions/Data",
+              "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
             },
             "datasets": {
               "additionalProperties": {
@@ -5415,10 +5460,11 @@
                   "type": "array"
                 }
               ],
-              "description": "A description of the view. Multiple lines can be provided as an array."
+              "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
             "encoding": {
-              "$ref": "#/definitions/Encoding"
+              "$ref": "#/definitions/Encoding",
+              "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
             },
             "genome": {
               "$ref": "#/definitions/GenomeConfig"
@@ -5439,7 +5485,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
             },
             "layer": {
               "items": {
@@ -5458,18 +5504,19 @@
               "type": "array"
             },
             "name": {
+              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
               "type": "string"
             },
             "opacity": {
               "$ref": "#/definitions/ViewOpacityDef",
-              "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
+              "description": "Opacity of the view and all its children. Allows implementing semantic zooming where the layers are faded in and out as the user zooms in and out.\n\nTODO: Write proper documentation with examples.\n\n**Default:** `1.0`"
             },
             "padding": {
               "$ref": "#/definitions/PaddingConfig",
-              "description": "Padding in pixels.\n\n**Default:* `0`"
+              "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
             },
             "params": {
-              "description": "Dynamic variables that parameterize a visualization.",
+              "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
               "items": {
                 "$ref": "#/definitions/Parameter"
               },
@@ -5477,6 +5524,7 @@
             },
             "resolve": {
               "additionalProperties": false,
+              "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
               "properties": {
                 "axis": {
                   "additionalProperties": {
@@ -5507,7 +5555,7 @@
               "additionalProperties": {
                 "$ref": "#/definitions/ViewSpec"
               },
-              "description": "Templates that can be reused within the view specification by importing them with the template key.",
+              "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
               "type": "object"
             },
             "title": {
@@ -5518,9 +5566,11 @@
                 {
                   "$ref": "#/definitions/Title"
                 }
-              ]
+              ],
+              "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
             },
             "transform": {
+              "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
               "items": {
                 "$ref": "#/definitions/TransformParams"
               },
@@ -5542,7 +5592,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
             },
             "viewportWidth": {
               "anyOf": [
@@ -5557,10 +5607,10 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
             },
             "visible": {
-              "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+              "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
               "type": "boolean"
             },
             "width": {
@@ -5579,7 +5629,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
             }
           },
           "required": [
@@ -5598,15 +5648,16 @@
               "type": "string"
             },
             "baseUrl": {
-              "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+              "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
               "type": "string"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
-              "$ref": "#/definitions/Data"
+              "$ref": "#/definitions/Data",
+              "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
             },
             "datasets": {
               "additionalProperties": {
@@ -5628,10 +5679,11 @@
                   "type": "array"
                 }
               ],
-              "description": "A description of the view. Multiple lines can be provided as an array."
+              "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
             "encoding": {
-              "$ref": "#/definitions/Encoding"
+              "$ref": "#/definitions/Encoding",
+              "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
             },
             "genome": {
               "$ref": "#/definitions/GenomeConfig"
@@ -5652,21 +5704,18 @@
                   "type": "string"
                 }
               ],
-              "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
             },
             "name": {
+              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
               "type": "string"
             },
-            "opacity": {
-              "$ref": "#/definitions/ViewOpacityDef",
-              "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
-            },
             "padding": {
               "$ref": "#/definitions/PaddingConfig",
-              "description": "Padding in pixels.\n\n**Default:* `0`"
+              "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
             },
             "params": {
-              "description": "Dynamic variables that parameterize a visualization.",
+              "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
               "items": {
                 "$ref": "#/definitions/Parameter"
               },
@@ -5674,6 +5723,7 @@
             },
             "resolve": {
               "additionalProperties": false,
+              "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
               "properties": {
                 "axis": {
                   "additionalProperties": {
@@ -5708,7 +5758,7 @@
               "additionalProperties": {
                 "$ref": "#/definitions/ViewSpec"
               },
-              "description": "Templates that can be reused within the view specification by importing them with the template key.",
+              "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
               "type": "object"
             },
             "title": {
@@ -5719,9 +5769,11 @@
                 {
                   "$ref": "#/definitions/Title"
                 }
-              ]
+              ],
+              "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
             },
             "transform": {
+              "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
               "items": {
                 "$ref": "#/definitions/TransformParams"
               },
@@ -5754,7 +5806,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
             },
             "viewportWidth": {
               "anyOf": [
@@ -5769,10 +5821,10 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
             },
             "visible": {
-              "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+              "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
               "type": "boolean"
             },
             "width": {
@@ -5791,7 +5843,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
             }
           },
           "required": [
@@ -5810,15 +5862,16 @@
               "type": "string"
             },
             "baseUrl": {
-              "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+              "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
               "type": "string"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
-              "$ref": "#/definitions/Data"
+              "$ref": "#/definitions/Data",
+              "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
             },
             "datasets": {
               "additionalProperties": {
@@ -5840,10 +5893,11 @@
                   "type": "array"
                 }
               ],
-              "description": "A description of the view. Multiple lines can be provided as an array."
+              "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
             "encoding": {
-              "$ref": "#/definitions/Encoding"
+              "$ref": "#/definitions/Encoding",
+              "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
             },
             "genome": {
               "$ref": "#/definitions/GenomeConfig"
@@ -5878,21 +5932,18 @@
                   "type": "string"
                 }
               ],
-              "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
             },
             "name": {
+              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
               "type": "string"
             },
-            "opacity": {
-              "$ref": "#/definitions/ViewOpacityDef",
-              "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
-            },
             "padding": {
               "$ref": "#/definitions/PaddingConfig",
-              "description": "Padding in pixels.\n\n**Default:* `0`"
+              "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
             },
             "params": {
-              "description": "Dynamic variables that parameterize a visualization.",
+              "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
               "items": {
                 "$ref": "#/definitions/Parameter"
               },
@@ -5900,6 +5951,7 @@
             },
             "resolve": {
               "additionalProperties": false,
+              "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
               "properties": {
                 "axis": {
                   "additionalProperties": {
@@ -5934,7 +5986,7 @@
               "additionalProperties": {
                 "$ref": "#/definitions/ViewSpec"
               },
-              "description": "Templates that can be reused within the view specification by importing them with the template key.",
+              "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
               "type": "object"
             },
             "title": {
@@ -5945,9 +5997,11 @@
                 {
                   "$ref": "#/definitions/Title"
                 }
-              ]
+              ],
+              "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
             },
             "transform": {
+              "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
               "items": {
                 "$ref": "#/definitions/TransformParams"
               },
@@ -5966,7 +6020,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
             },
             "viewportWidth": {
               "anyOf": [
@@ -5981,10 +6035,10 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
             },
             "visible": {
-              "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+              "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
               "type": "boolean"
             },
             "width": {
@@ -6003,7 +6057,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
             }
           },
           "required": [
@@ -6022,7 +6076,7 @@
               "type": "string"
             },
             "baseUrl": {
-              "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+              "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
               "type": "string"
             },
             "columns": {
@@ -6044,11 +6098,12 @@
               "type": "array"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
-              "$ref": "#/definitions/Data"
+              "$ref": "#/definitions/Data",
+              "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
             },
             "datasets": {
               "additionalProperties": {
@@ -6070,10 +6125,11 @@
                   "type": "array"
                 }
               ],
-              "description": "A description of the view. Multiple lines can be provided as an array."
+              "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
             "encoding": {
-              "$ref": "#/definitions/Encoding"
+              "$ref": "#/definitions/Encoding",
+              "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
             },
             "genome": {
               "$ref": "#/definitions/GenomeConfig"
@@ -6094,21 +6150,18 @@
                   "type": "string"
                 }
               ],
-              "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
             },
             "name": {
+              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
               "type": "string"
             },
-            "opacity": {
-              "$ref": "#/definitions/ViewOpacityDef",
-              "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
-            },
             "padding": {
               "$ref": "#/definitions/PaddingConfig",
-              "description": "Padding in pixels.\n\n**Default:* `0`"
+              "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
             },
             "params": {
-              "description": "Dynamic variables that parameterize a visualization.",
+              "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
               "items": {
                 "$ref": "#/definitions/Parameter"
               },
@@ -6116,6 +6169,7 @@
             },
             "resolve": {
               "additionalProperties": false,
+              "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
               "properties": {
                 "axis": {
                   "additionalProperties": {
@@ -6150,7 +6204,7 @@
               "additionalProperties": {
                 "$ref": "#/definitions/ViewSpec"
               },
-              "description": "Templates that can be reused within the view specification by importing them with the template key.",
+              "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
               "type": "object"
             },
             "title": {
@@ -6161,9 +6215,11 @@
                 {
                   "$ref": "#/definitions/Title"
                 }
-              ]
+              ],
+              "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
             },
             "transform": {
+              "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
               "items": {
                 "$ref": "#/definitions/TransformParams"
               },
@@ -6182,7 +6238,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
             },
             "viewportWidth": {
               "anyOf": [
@@ -6197,10 +6253,10 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
             },
             "visible": {
-              "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+              "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
               "type": "boolean"
             },
             "width": {
@@ -6219,7 +6275,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
             }
           },
           "required": [
@@ -6239,15 +6295,16 @@
               "type": "string"
             },
             "baseUrl": {
-              "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+              "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
               "type": "string"
             },
             "configurableVisibility": {
-              "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+              "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
               "type": "boolean"
             },
             "data": {
-              "$ref": "#/definitions/Data"
+              "$ref": "#/definitions/Data",
+              "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
             },
             "datasets": {
               "additionalProperties": {
@@ -6269,10 +6326,11 @@
                   "type": "array"
                 }
               ],
-              "description": "A description of the view. Multiple lines can be provided as an array."
+              "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
             },
             "encoding": {
-              "$ref": "#/definitions/Encoding"
+              "$ref": "#/definitions/Encoding",
+              "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
             },
             "genome": {
               "$ref": "#/definitions/GenomeConfig"
@@ -6293,21 +6351,18 @@
                   "type": "string"
                 }
               ],
-              "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
             },
             "name": {
+              "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
               "type": "string"
             },
-            "opacity": {
-              "$ref": "#/definitions/ViewOpacityDef",
-              "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
-            },
             "padding": {
               "$ref": "#/definitions/PaddingConfig",
-              "description": "Padding in pixels.\n\n**Default:* `0`"
+              "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
             },
             "params": {
-              "description": "Dynamic variables that parameterize a visualization.",
+              "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
               "items": {
                 "$ref": "#/definitions/Parameter"
               },
@@ -6315,6 +6370,7 @@
             },
             "resolve": {
               "additionalProperties": false,
+              "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
               "properties": {
                 "axis": {
                   "additionalProperties": {
@@ -6363,7 +6419,7 @@
               "additionalProperties": {
                 "$ref": "#/definitions/ViewSpec"
               },
-              "description": "Templates that can be reused within the view specification by importing them with the template key.",
+              "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
               "type": "object"
             },
             "title": {
@@ -6374,9 +6430,11 @@
                 {
                   "$ref": "#/definitions/Title"
                 }
-              ]
+              ],
+              "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
             },
             "transform": {
+              "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
               "items": {
                 "$ref": "#/definitions/TransformParams"
               },
@@ -6399,7 +6457,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+              "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
             },
             "viewportWidth": {
               "anyOf": [
@@ -6414,10 +6472,10 @@
                   "type": "string"
                 }
               ],
-              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+              "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
             },
             "visible": {
-              "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+              "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
               "type": "boolean"
             },
             "width": {
@@ -6436,7 +6494,7 @@
                   "type": "string"
                 }
               ],
-              "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+              "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
             }
           },
           "required": [
@@ -6470,7 +6528,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Color of the mark. Affects either `fill` or `stroke`, depending on the `filled` property."
         },
         "minBufferSize": {
           "description": "Minimum size for WebGL buffers (number of data items). Allows for using `bufferSubData()` to update graphics.\n\nThis property is intended for internal use.",
@@ -6495,7 +6554,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Opacity of the mark. Affects `fillOpacity` or `strokeOpacity`, depending on the `filled` property."
         },
         "size": {
           "anyOf": [
@@ -6541,7 +6601,7 @@
         },
         "tooltip": {
           "$ref": "#/definitions/Tooltip",
-          "description": "Tooltip handler. If `null`, no tooltip is shown."
+          "description": "Tooltip handler. If `null`, no tooltip is shown. If string, specifies the [tooltip handler](https://genomespy.app/docs/api/#custom-tooltip-handlers) to use."
         },
         "type": {
           "const": "rule",
@@ -6555,7 +6615,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Position on the x axis."
         },
         "x2": {
           "anyOf": [
@@ -6565,7 +6626,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "The secondary position on the x axis."
         },
         "xOffset": {
           "description": "Offsets of the `x` and `x2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
@@ -6579,7 +6641,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Position on the y axis."
         },
         "y2": {
           "anyOf": [
@@ -6589,7 +6652,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "The secondary position on the y axis."
         },
         "yOffset": {
           "description": "Offsets of the `y` and `y2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
@@ -6726,15 +6790,16 @@
       "description": "A view specification for a SampleView. This is only functional in the GenomeSpy app.",
       "properties": {
         "baseUrl": {
-          "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+          "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
           "type": "string"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
-          "$ref": "#/definitions/Data"
+          "$ref": "#/definitions/Data",
+          "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
         },
         "description": {
           "anyOf": [
@@ -6748,10 +6813,11 @@
               "type": "array"
             }
           ],
-          "description": "A description of the view. Multiple lines can be provided as an array."
+          "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
         "encoding": {
-          "$ref": "#/definitions/Encoding"
+          "$ref": "#/definitions/Encoding",
+          "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
         },
         "height": {
           "anyOf": [
@@ -6769,21 +6835,18 @@
               "type": "string"
             }
           ],
-          "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
         },
         "name": {
+          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
           "type": "string"
         },
-        "opacity": {
-          "$ref": "#/definitions/ViewOpacityDef",
-          "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
-        },
         "padding": {
           "$ref": "#/definitions/PaddingConfig",
-          "description": "Padding in pixels.\n\n**Default:* `0`"
+          "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
         },
         "params": {
-          "description": "Dynamic variables that parameterize a visualization.",
+          "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
           "items": {
             "$ref": "#/definitions/Parameter"
           },
@@ -6791,6 +6854,7 @@
         },
         "resolve": {
           "additionalProperties": false,
+          "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
           "properties": {
             "axis": {
               "additionalProperties": {
@@ -6839,7 +6903,7 @@
           "additionalProperties": {
             "$ref": "#/definitions/ViewSpec"
           },
-          "description": "Templates that can be reused within the view specification by importing them with the template key.",
+          "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
           "type": "object"
         },
         "title": {
@@ -6850,9 +6914,11 @@
             {
               "$ref": "#/definitions/Title"
             }
-          ]
+          ],
+          "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
         },
         "transform": {
+          "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
           "items": {
             "$ref": "#/definitions/TransformParams"
           },
@@ -6875,7 +6941,7 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
         },
         "viewportWidth": {
           "anyOf": [
@@ -6890,10 +6956,10 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
         },
         "visible": {
-          "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+          "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
           "type": "boolean"
         },
         "width": {
@@ -6912,7 +6978,7 @@
               "type": "string"
             }
           ],
-          "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
         }
       },
       "required": [
@@ -7395,7 +7461,7 @@
       "additionalProperties": false,
       "properties": {
         "grow": {
-          "description": "Share of the remaining space",
+          "description": "Share of the remaining space. See [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.",
           "type": "number"
         },
         "px": {
@@ -7625,7 +7691,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Color of the mark. Affects either `fill` or `stroke`, depending on the `filled` property."
         },
         "dx": {
           "description": "The horizontal offset between the text and its anchor point, in pixels. Applied after the rotation by `angle`.",
@@ -7703,7 +7770,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Opacity of the mark. Affects `fillOpacity` or `strokeOpacity`, depending on the `filled` property."
         },
         "paddingX": {
           "anyOf": [
@@ -7762,7 +7830,7 @@
         },
         "tooltip": {
           "$ref": "#/definitions/Tooltip",
-          "description": "Tooltip handler. If `null`, no tooltip is shown."
+          "description": "Tooltip handler. If `null`, no tooltip is shown. If string, specifies the [tooltip handler](https://genomespy.app/docs/api/#custom-tooltip-handlers) to use."
         },
         "type": {
           "const": "text",
@@ -7800,7 +7868,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Position on the x axis."
         },
         "x2": {
           "anyOf": [
@@ -7810,7 +7879,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "The secondary position on the x axis."
         },
         "xOffset": {
           "description": "Offsets of the `x` and `x2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
@@ -7824,7 +7894,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "Position on the y axis."
         },
         "y2": {
           "anyOf": [
@@ -7834,7 +7905,8 @@
             {
               "$ref": "#/definitions/ExprRef"
             }
-          ]
+          ],
+          "description": "The secondary position on the y axis."
         },
         "yOffset": {
           "description": "Offsets of the `y` and `y2` coordinates in pixels. The offset is applied after the viewport scaling and translation.\n\n**Default value:** `0`",
@@ -8072,6 +8144,7 @@
       "additionalProperties": false,
       "properties": {
         "aggregateSamples": {
+          "description": "Specifies views that [aggregate](https://genomespy.app/docs/sample-collections/visualizing/#aggregation) multiple samples within the GenomeSpy App.",
           "items": {
             "anyOf": [
               {
@@ -8085,15 +8158,16 @@
           "type": "array"
         },
         "baseUrl": {
-          "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+          "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
           "type": "string"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
-          "$ref": "#/definitions/Data"
+          "$ref": "#/definitions/Data",
+          "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
         },
         "description": {
           "anyOf": [
@@ -8107,10 +8181,11 @@
               "type": "array"
             }
           ],
-          "description": "A description of the view. Multiple lines can be provided as an array."
+          "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
         "encoding": {
-          "$ref": "#/definitions/Encoding"
+          "$ref": "#/definitions/Encoding",
+          "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
         },
         "height": {
           "anyOf": [
@@ -8128,7 +8203,7 @@
               "type": "string"
             }
           ],
-          "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
         },
         "mark": {
           "anyOf": [
@@ -8138,21 +8213,23 @@
             {
               "$ref": "#/definitions/MarkProps"
             }
-          ]
+          ],
+          "description": "The graphical mark presenting the data objects."
         },
         "name": {
+          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
           "type": "string"
         },
         "opacity": {
           "$ref": "#/definitions/ViewOpacityDef",
-          "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
+          "description": "Opacity of the view and all its children. Allows implementing semantic zooming where the layers are faded in and out as the user zooms in and out.\n\nTODO: Write proper documentation with examples.\n\n**Default:** `1.0`"
         },
         "padding": {
           "$ref": "#/definitions/PaddingConfig",
-          "description": "Padding in pixels.\n\n**Default:* `0`"
+          "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
         },
         "params": {
-          "description": "Dynamic variables that parameterize a visualization.",
+          "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
           "items": {
             "$ref": "#/definitions/Parameter"
           },
@@ -8160,6 +8237,7 @@
         },
         "resolve": {
           "additionalProperties": false,
+          "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
           "properties": {
             "axis": {
               "additionalProperties": {
@@ -8190,7 +8268,7 @@
           "additionalProperties": {
             "$ref": "#/definitions/ViewSpec"
           },
-          "description": "Templates that can be reused within the view specification by importing them with the template key.",
+          "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
           "type": "object"
         },
         "title": {
@@ -8201,16 +8279,19 @@
             {
               "$ref": "#/definitions/Title"
             }
-          ]
+          ],
+          "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
         },
         "transform": {
+          "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
           "items": {
             "$ref": "#/definitions/TransformParams"
           },
           "type": "array"
         },
         "view": {
-          "$ref": "#/definitions/ViewBackground"
+          "$ref": "#/definitions/ViewBackground",
+          "description": "The background of the view, including fill, stroke, and stroke width."
         },
         "viewportHeight": {
           "anyOf": [
@@ -8225,7 +8306,7 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
         },
         "viewportWidth": {
           "anyOf": [
@@ -8240,10 +8321,10 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
         },
         "visible": {
-          "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+          "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
           "type": "boolean"
         },
         "width": {
@@ -8262,7 +8343,7 @@
               "type": "string"
             }
           ],
-          "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
         }
       },
       "required": [
@@ -8321,15 +8402,16 @@
       "additionalProperties": false,
       "properties": {
         "baseUrl": {
-          "description": "Optional base URL for constructing request URLs. When set, all views deeper in the hierarchy inherit this base URL, using it for importing loading data and importing specifications.",
+          "description": "The base URL for relative URL data sources and URL [imports](https://genomespy.app/docs/grammar/import/#importing-from-a-url). The base URLs are inherited in the view hierarchy unless overridden with this property. By default, the top-level view's base URL equals to the visualization specification's base URL.",
           "type": "string"
         },
         "configurableVisibility": {
-          "description": "Is the visibility configurable interactively from the App. Configurability requires that the view has an explicitly specified name that is *unique* in within the view specification.\n\n**Default:** `false` for children of `layer`, `true` for others.",
+          "description": "Is the visibility configurable interactively from the [GenomeSpy App](https://genomespy.app/docs/sample-collections/). Configurability requires that the view has an explicitly specified name that is *unique* in within the view hierarchy.\n\n**Default:** `false` for children of `layer`, `true` for others.",
           "type": "boolean"
         },
         "data": {
-          "$ref": "#/definitions/Data"
+          "$ref": "#/definitions/Data",
+          "description": "Specifies a [data source](https://genomespy.app/docs/grammar/data/). If omitted, the data source is inherited from the parent view."
         },
         "description": {
           "anyOf": [
@@ -8343,10 +8425,11 @@
               "type": "array"
             }
           ],
-          "description": "A description of the view. Multiple lines can be provided as an array."
+          "description": "A description of the view. Can be used for documentation. The description of the top-level view is shown in the toolbar of the [GenomeSpy App](https://genomespy.app/docs/sample-collections/)."
         },
         "encoding": {
-          "$ref": "#/definitions/Encoding"
+          "$ref": "#/definitions/Encoding",
+          "description": "Specifies how data are [encoded](https://genomespy.app/docs/grammar/mark/#encoding) using the visual channels."
         },
         "height": {
           "anyOf": [
@@ -8364,21 +8447,18 @@
               "type": "string"
             }
           ],
-          "description": "Height of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Height of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default value:** `\"container\"`"
         },
         "name": {
+          "description": "An internal name that can be used for referring the view. For referencing purposes, the name should be unique within the view hierarchy.",
           "type": "string"
         },
-        "opacity": {
-          "$ref": "#/definitions/ViewOpacityDef",
-          "description": "Opacity of the view and all its children.\n\n**Default:** `1.0`"
-        },
         "padding": {
           "$ref": "#/definitions/PaddingConfig",
-          "description": "Padding in pixels.\n\n**Default:* `0`"
+          "description": "Padding applied to the view. Accepts either a number representing pixels or an object specifying separate paddings for each edge.\n\nExamples:\n- `padding: 10`\n- `padding: { top: 10, right: 20, bottom: 10, left: 20 }`\n\n**Default value:** `0`"
         },
         "params": {
-          "description": "Dynamic variables that parameterize a visualization.",
+          "description": "Dynamic variables that [parameterize](https://genomespy.app/docs/grammar/parameters/) a visualization.",
           "items": {
             "$ref": "#/definitions/Parameter"
           },
@@ -8386,6 +8466,7 @@
         },
         "resolve": {
           "additionalProperties": false,
+          "description": "Specifies how scales and axes are [resolved](https://genomespy.app/docs/grammar/composition/#scale-and-axis-resolution) in the view hierarchy.",
           "properties": {
             "axis": {
               "additionalProperties": {
@@ -8420,7 +8501,7 @@
           "additionalProperties": {
             "$ref": "#/definitions/ViewSpec"
           },
-          "description": "Templates that can be reused within the view specification by importing them with the template key.",
+          "description": "[Templates](https://genomespy.app/docs/grammar/import/#repeating-with-named-templates) that can be reused within the view specification by importing them with the template key.",
           "type": "object"
         },
         "title": {
@@ -8431,9 +8512,11 @@
             {
               "$ref": "#/definitions/Title"
             }
-          ]
+          ],
+          "description": "View title. N.B.: Currently, GenomeSpy doesn't do bound calculation, and you need to manually specify proper padding for the view to ensure that the title is visible."
         },
         "transform": {
+          "description": "An array of [transformations](https://genomespy.app/docs/grammar/transform/) applied to the data before visual encoding.",
           "items": {
             "$ref": "#/definitions/TransformParams"
           },
@@ -8466,7 +8549,7 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
+          "description": "Optional viewport height of the view. If the view size exceeds the viewport height, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `height`)"
         },
         "viewportWidth": {
           "anyOf": [
@@ -8481,10 +8564,10 @@
               "type": "string"
             }
           ],
-          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with scrollbars. This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
+          "description": "Optional viewport width of the view. If the view size exceeds the viewport width, it will be shown with [scrollbars](https://genomespy.app/docs/grammar/composition/concat/#scrollable-viewports). This property implicitly enables clipping.\n\n**Default:** `null` (same as `width`)"
         },
         "visible": {
-          "description": "Visibility of the view. An invisible view is removed from the layout and not rendered.\n\n**Default:** `true`",
+          "description": "The default visibility of the view. An invisible view is removed from the layout and not rendered. For context, see [toggleable view visibility](https://genomespy.app/docs/sample-collections/visualizing/#toggleable-view-visibility).\n\n**Default:** `true`",
           "type": "boolean"
         },
         "width": {
@@ -8503,7 +8586,7 @@
               "type": "string"
             }
           ],
-          "description": "Width of the view. If a number, it is interpreted as pixels.\n\n**Default:** `\"container\"`"
+          "description": "Width of the view. If a number, it is interpreted as pixels. Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing) for details.\n\n**Default:** `\"container\"`"
         }
       },
       "required": [
@@ -8671,7 +8754,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "The fill color"
+          "description": "The fill color."
         },
         "fillOpacity": {
           "anyOf": [
@@ -8682,7 +8765,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "The fill opacity. Value between [0, 1]."
+          "description": "The fill opacity. Value between `0` and `1`."
         },
         "stroke": {
           "anyOf": [
@@ -8704,7 +8787,7 @@
               "$ref": "#/definitions/ExprRef"
             }
           ],
-          "description": "The stroke opacity. Value between [0, 1]."
+          "description": "The stroke opacity. Value between `0` and `1`."
         },
         "strokeWidth": {
           "description": "The stroke width in pixels.",