docs(traversal): improvements

Author: tony

docs/topics/traversal.md

@@ -5,88 +5,90 @@
 libtmux convenient access to move around the hierachy of sessions,
 windows and panes in tmux.
 
-this is done by libtmux's object abstraction of {}`target`\_s (the `-t`
-command) and the permanent internal ID's tmux gives to objects.
+This is done by libtmux's object abstraction of {term}`target`s (the `-t`
+argument) and the permanent internal ID's tmux gives to objects.
 
-open two terminals:
+Open two terminals:
 
-terminal one: start tmux in a seperate terminal:
+Terminal one: start tmux in a seperate terminal:
 
-```
+```console
 $ tmux
 ```
 
-terminal two, `python` or `ptpython` if you have it:
+Terminal two, `python` or `ptpython` if you have it:
 
-```
+```console
 $ python
 ```
 
-import tmux:
+Import `libtmux`:
 
-```
-import tmux
+```python
+import libtmux
 ```
 
-attach default tmux {class}`libtmux.Server` to `t`:
+Attach default tmux {class}`~libtmux.Server` to `t`:
 
-```
+```python
 >>> t = libtmux.Server();
 >>> t
 <libtmux.server.Server object at 0x10edd31d0>
 ```
 
-get first session {class}`Session` to {}`session`:
+Get first session {class}`~libtmux.Session` to `session`:
 
-```
+```python
 >>> session = t.sessions[0]
 >>> session
 Session($0 libtmux)
 ```
 
-get a list of sessions:
+Get a list of sessions:
 
-```
+```python
 >>> t.sessions
 [Session($0 libtmux), Session($1 tmuxp)]
 ```
 
-iterate through sessions in a server:
+Iterate through sessions in a server:
 
-```
+```python
 >>> for sess in t.sessions:
 ...     print(sess)
 
 Session($0 libtmux)
 Session($1 tmuxp)
 ```
 
-grab a {class}`Window` from a session:
+Grab a {class}`~libtmux.Window` from a session:
 
-```
+```python
 >>> session.windows[0]
 Window(@1 1:libtmux, Session($0 libtmux))
 ```
 
-grab the currently focused window from session:
-
-> > > > session.attached_window
-> > > > Window(@2 2:docs, Session($0 libtmux))grab the currently focused {class}`Pane` from session:
+Grab the currently focused window from session:
 
+```python
+>>> session.attached_window
+>>> Window(@2 2:docs, Session($0 libtmux))grab the currently focused {class}`Pane` from session:
 ```
+
+```python
 >>> session.attached_pane
 Pane(%5 Window(@2 2:docs, Session($0 libtmux)))
 ```
 
-assign the attached pane to `p`:
+Assign the attached {class}`~libtmux.Pane` to `p`:
 
-```
+```python
 >>> p = session.attached_pane
 ```
 
-access the window/server of a pane:
+Access the window/server of a pane:
 
-```
+```python
 >>> p.window
 Window(@2 2:docs, Session($0 libtmux))