Doc updates

Author: tony

doc/about.rst

@@ -8,17 +8,17 @@ About
 
 tmuxp helps you manage tmux workspaces.
 
-tmuxp is build upon an object relational mapper for tmux. End-users may
-use YAML, JSON and :py:obj:`dict` configurations to launch workspaces like
+Built on a object relational mapper for tmux. tmux users can reload common
+workspaces from YAML, JSON and :py:obj:`dict` configurations like
 `tmuxinator`_ and `teamocil`_.
 
 To jump right in, see :ref:`quickstart` and :ref:`examples`.
 
 Interested in some kung-fu or joining the effort? :ref:`api` and
 :ref:`developing`
 
-License  is `BSD-licensed`_. Code can be found at github at
-http://github.com/tony/tmuxp.
+`BSD-licensed`_. Code can be found on `github
+<http://github.com/tony/tmuxp.>`_
 
 Differences from tmuxinator / teamocil
 --------------------------------------

doc/about_tmux.rst

@@ -308,17 +308,15 @@ Windows can be *named upon creation*.
 
     $ tmuxp new-window [-n window-name]
 
-.. _Rename window:
-
 Windows can be *renamed after creation*.
 
-=============== =========================================================
+=============== ==========================================================
 Command         .. code-block:: bash
 
                     $ tmux rename-window <new-name>
 
 Short cut       ``Prefix`` + ``,``
-=============== =========================================================
+=============== ==========================================================
 
 Creating new windows
 --------------------
@@ -330,7 +328,7 @@ Command         .. code-block:: bash
 
 Short cut       ``Prefix`` + ``c``
 
-                You may then :ref:`Rename window`.
+                You may then rename window.
 =============== =========================================================
 
 Traverse windows

doc/cli.rst

@@ -4,6 +4,32 @@
 Command Line Interface
 ======================
 
+.. _bash_completion:
+
+Bash completion
+"""""""""""""""
+
+For bash, ``.bashrc``:
+
+.. code-block:: bash
+
+    $ source tmuxp.bash
+
+For tcsh, ``.tcshrc``:
+
+.. code-block:: bash
+
+    $ complete tmuxp 'p/*/`tmuxp.tcsh`/'
+
+For zsh, ``.zshrc``:
+
+.. code-block:: bash
+
+    $ source tmuxp.zsh
+
+.. _commands:
+
+
 .. _cli_freeze:
 
 Freeze sessions
@@ -89,31 +115,6 @@ Convert between YAML and JSON
     tmuxp automatically will prompt to convert ``.yaml`` to ``.json`` and
     ``.json`` to  ``.yaml``.
 
-.. _bash_completion:
-
-Bash completion
-"""""""""""""""
-
-For bash, ``.bashrc``:
-
-.. code-block:: bash
-
-    $ source tmuxp.bash
-
-For tcsh, ``.tcshrc``:
-
-.. code-block:: bash
-
-    $ complete tmuxp 'p/*/`tmuxp.tcsh`/'
-
-For zsh, ``.zshrc``:
-
-.. code-block:: bash
-
-    $ source tmuxp.zsh
-
-.. _commands:
-
 Other commands
 """"""""""""""