docs(examples): main-pane-height percentage

Author: tony

docs/configuration/examples.md

@@ -554,6 +554,30 @@ pane during creation.
 
 ## Main pane height
 
+### Percentage
+
+:::{versionadded} 1.46.0
+
+Before this, tmuxp layouts would not detect the terminal's size.
+
+:::
+
+````{tab} YAML
+```{literalinclude} ../../examples/main-pane-height-percentage.yaml
+:language: yaml
+
+```
+````
+
+````{tab} JSON
+```{literalinclude} ../../examples/main-pane-height-percentage.json
+:language: json
+
+```
+````
+
+### Rows
+
 ````{tab} YAML
 ```{literalinclude} ../../examples/main-pane-height.yaml
 :language: yaml

examples/main-pane-height-percentage.json

@@ -0,0 +1,31 @@
+{
+  "windows": [
+    {
+      "panes": [
+        {
+          "shell_command": [
+            "top"
+          ], 
+          "start_directory": "~"
+        }, 
+        {
+          "shell_command": [
+            "echo \"hey\""
+          ]
+        }, 
+        {
+          "shell_command": [
+            "echo \"moo\""
+          ]
+        }
+      ], 
+      "layout": "main-horizontal", 
+      "options": {
+        "main-pane-height": "67%"
+      }, 
+      "window_name": "editor"
+    }
+  ], 
+  "session_name": "main pane height", 
+  "start_directory": "~"
+}

examples/main-pane-height-percentage.yaml

@@ -0,0 +1,15 @@
+session_name: main-pane-height
+start_directory: "~"
+windows:
+  - layout: main-horizontal
+    options:
+      main-pane-height: 67%
+    panes:
+      - shell_command:
+          - top
+        start_directory: "~"
+      - shell_command:
+          - echo "hey"
+      - shell_command:
+          - echo "moo"
+    window_name: my window name