Added the documentation to the example.md file instead.

As the examples.rst files was replaced by the md-files in the main line.

Author: jerri

docs/examples.md

@@ -307,6 +307,26 @@ without `window_index` will use the lowest available window index.
 
 ```
 
+## Shell per pane
+
+Every pane can have its own shell or application started. This allows for usage
+of the ``remain-on-exit`` setting to be used properly, but also to have
+different shells on different panes.
+
+### YAML
+
+```{literalinclude} ../examples/pane-shell.yaml
+:language: yaml
+
+```
+
+### JSON
+
+```{literalinclude} ../examples/pane-shell.json
+:language: json
+
+```
+
 ## Set tmux options
 
 Works with global (server-wide) options, session options