glamorous doc updates

Author: tony

doc/developing.rst

@@ -186,8 +186,10 @@ To run test where :ref:`test_builder_visually` you may:
 .. _watching_testrunner: https://pypi.python.org/pypi/watching_testrunner/1.0
 .. _pypi: https://pypi.python.org/pypi
 
-Super power
-"""""""""""
+.. _tmuxp developer config:
+
+tmuxp developer config
+""""""""""""""""""""""
 
 .. image:: _static/tmuxp-dev-screenshot.png
     :scale: 100%

doc/examples.rst

@@ -7,17 +7,19 @@ Examples
 2 split panes
 -------------
 
-.. aafig::
-
-   +--------+--------+
-   | $ pwd           |
-   |                 |
-   |                 |
-   +-----------------+
-   | $ pwd           |
-   |                 |
-   |                 |
-   +-----------------+
+.. sidebar:: 2 pane
+
+    .. aafig::
+
+        +-----------------+
+        | $ pwd           |
+        |                 |
+        |                 |
+        +-----------------+
+        | $ pwd           |
+        |                 |
+        |                 |
+        +-----------------+
 
 YAML - Short form:
 
@@ -32,40 +34,52 @@ YAML - Christmas Tree:
 3 panes
 -------
 
-.. aafig::
+.. sidebar:: 3 panes
 
-   +--------+--------+
-   | $ pwd  | $ pwd  |
-   |        |        |
-   |        |        |
-   +--------+--------+
-   | $ pwd  | $ pwd  |
-   |        |        |
-   |        |        |
-   +--------+--------+
+    .. aafig::
+
+        +-----------------+
+        | $ pwd           |
+        |                 |
+        |                 |
+        +--------+--------+
+        | $ pwd  | $ pwd  |
+        |        |        |
+        |        |        |
+        +--------+--------+
 
 .. literalinclude:: ../examples/3-pane.yaml
     :language: yaml
 
 4 panes
 -------
 
-.. aafig::
+.. sidebar:: 4 panes
 
-   +-----------------+
-   | $ pwd           |
-   |                 |
-   |                 |
-   +--------+--------+
-   | $ pwd  | $ pwd  |
-   |        |        |
-   |        |        |
-   +--------+--------+
+    .. aafig::
 
+        +--------+--------+
+        | $ pwd  | $ pwd  |
+        |        |        |
+        |        |        |
+        +--------+--------+
+        | $ pwd  | $ pwd  |
+        |        |        |
+        |        |        |
+        +--------+--------+
 
 .. literalinclude:: ../examples/4-pane.yaml
     :language: yaml
 
+Super-advanced dev environment
+------------------------------
+
+.. seealso::
+    :ref:`tmuxp developer config` in the :ref:`developing` section.
+
+.. literalinclude:: ../.tmuxp.yaml
+    :language: yaml
+
 Kung fu
 -------
 

doc/quickstart.rst

@@ -38,7 +38,7 @@ It will list configs available in the current directory and
 
 This creates your tmuxp session.
 
-.. seealso:: :ref:`quickstart`
+.. seealso:: :ref:`examples`
 
 Bash completion
 """""""""""""""
@@ -80,7 +80,8 @@ Conventions
 
 .. module:: tmuxp
 
-.. seealso:: :ref:`tmuxp python API documentation <api>`
+.. seealso::
+    :ref:`tmuxp python API documentation <api>` and :ref:`developing`.
 
 ======================================== =================================
 :ref:`tmuxp python api <api>`            :term:`tmux(1)` equivalent