From e886820fe9f0fad9ac6e087d2fe9ae87dc116f2b Mon Sep 17 00:00:00 2001
From: Maxim Devaev <mdevaev@gmail.com>
Date: Fri, 18 Aug 2023 13:21:12 +0300
Subject: [PATCH] update

---
 docs/tailscale.md | 40 +++++++++++++++++++---------------------
 1 file changed, 19 insertions(+), 21 deletions(-)

diff --git a/docs/tailscale.md b/docs/tailscale.md
index 10e5a84e..8d1617d2 100644
--- a/docs/tailscale.md
+++ b/docs/tailscale.md
@@ -1,27 +1,24 @@
 # Tailscale VPN
 
-The [Tailscale](https://tailscale.com/) can be used to access PiKVM from the Internet
+The [Tailscale VPN](https://tailscale.com/) can be used to access PiKVM from the Internet
 when using [port forwarding](port_forwarding.md) is not possible or does not seem secure enough.
 Tailscale is a convenient and free (for private use) tool for organizing a small VPN network.
 
-
------
-## Installation
-
-Basic support like whats shown below is provided as an example,
+Basic Tailscale usage like whats shown below is provided as an example,
 any other setting or functionality needs to be redirected to the [Tailscale support](https://tailscale.com/contact/support/).
 
 
-### On the PiKVM side
+-----
+## Configuring the PiKVM
 
-1. Execute these commands:
+1. Install the client, run `tailscaled` service and register it in the network:
 
     ```
-    # rw
-    # pacman -Syu
-    # pacman -S tailscale-pikvm
-    # systemctl enable --now tailscaled
-    # tailscale up
+    [root@pikvm ~]# rw
+    [root@pikvm ~]# pacman -Syu
+    [root@pikvm ~]# pacman -S tailscale-pikvm
+    [root@pikvm ~]# systemctl enable --now tailscaled
+    [root@pikvm ~]# tailscale up
     ```
 
 2. Follow the link to authorize this installation.
@@ -40,7 +37,8 @@ If everything is successful, PiKVM will become a member of your VPN network.
     This is happening since Tailscale has weak support of read-only systems.
 
 
-### For each device you wish to access PiKVM
+-----
+## Configuring a client device
 
 * [Download](https://tailscale.com/download) and install the Tailscale client for your OS
     to the system you are using (not to the system you want to control).
@@ -48,18 +46,18 @@ If everything is successful, PiKVM will become a member of your VPN network.
 * Follow the URL in the web browser: `https://<tailscale_kvm_ip>` and you will see PiKVM web interface.
 
 
-----
+-----
 ## Troubleshooting
 
 If something not work, the usual advice is to completely remove the Tailscale from PiKVM and perform a clean installation.
 
-To remove follow this:
+To remove Tailscale follow this:
 
 ```
-# rw
-# pacman -Rscnd tailscale
-# rm -rf /var/lib/tailscale /var/cache/tailscale
-# reboot
+[root@pikvm ~]# rw
+[root@pikvm ~]# pacman -Rscnd tailscale
+[root@pikvm ~]# rm -rf /var/lib/tailscale /var/cache/tailscale
+[root@pikvm ~]# reboot
 ```
 
-Next, follow this document from the beginning to install the Tailscale again.
+Next, follow this page from the beginning to install the Tailscale again.