docs: Update for links, installation, etc

Author: tony

README.md

@@ -55,7 +55,7 @@ connect to a live tmux session:
 <libtmux.server.Server object at 0x7fbd622c1dd0>
 ```
 
-FYI: You can also use [tmuxp]'s [`tmuxp shell`] to drop straight into your
+Tip: You can also use [tmuxp]'s [`tmuxp shell`] to drop straight into your
 current tmux server / session / window pane.
 
 [tmuxp]: https://tmuxp.git-pull.com/

docs/properties.md

@@ -19,20 +19,6 @@ $ tmux
 
 Make sure you have {ref}`libtmux installed <installation>`:
 
-```{code-block} sh
-
-pip install libtmux
-
-```
-
-To upgrade:
-
-```{code-block} sh
-
-pip install -U libtmux
-
-```
-
 :::::
 
 terminal two, `python` or `ptpython` if you have it:

docs/quickstart.md

@@ -27,7 +27,7 @@ Next, ensure `libtmux` is installed:
 
 ```{code-block} bash
 
-$ [sudo] pip install libtmux
+$ pip install --user libtmux
 
 ```
 
@@ -65,15 +65,17 @@ $ python
 
 ```
 
-For commandline completion, you can also use [ptpython][ptpython].
+For commandline completion, you can also use [ptpython].
 
 ```{code-block} bash
 
-$ [sudo] pip install ptpython
+$ pip install --user ptpython
 $ ptpython
 
 ```
 
+[ptpython]: https://github.com/prompt-toolkit/ptpython
+
 ```{module} libtmux
 
 ```
@@ -89,6 +91,16 @@ First, we can grab a {class}`Server`.
 
 ```
 
+:::{tip}
+
+You can also use [tmuxp]'s [`tmuxp shell`] to drop straight into your
+current tmux server / session / window pane.
+
+[tmuxp]: https://tmuxp.git-pull.com/
+[`tmuxp shell`]: https://tmuxp.git-pull.com/cli.html#shell
+
+:::
+
 :::{note}
 
 You can specify a `socket_name`, `socket_path` and `config_file`