update

docs/_update_os.md

@@ -0,0 +1,20 @@
+To update, run following commands under the `root` user:
+
+```console
+[root@pikvm ~]# rw
+[root@pikvm ~]# pacman -Syu
+[root@pikvm ~]# reboot
+```
+
+If you encounter any error during the upgrade, it is most likely due to the upgrade of the Arch Linux ARM repository upstream.
+In this case, just use our script, which fixes this:
+
+```console
+[root@pikvm ~]# curl https://files.pikvm.org/update-os.sh | bash
+```
+
+Next time you will be able to use the usual method with `pacman -Syu`.
+
+Pacman saves all installed packages in a compressed format so that you can roll back to the old version if something goes wrong.
+After you've updated and made sure everything works, it makes sense to clear the package cache so that it doesn't take up space
+on the SD card (under the `root`): `rw; rm -rf /var/cache/pacman/pkg; ro`.

docs/faq.md

@@ -301,27 +301,8 @@ As a first step, we recommend carefully reading our documentation on [GitHub](ht
 
 
 ??? question "How do I update PiKVM with the latest software?"
-    This is ONLY recommended if you need a feature, otherwise this should ONLY be done if you are physically at the device and can reflash the sd card as a means of recovery. PiKVM OS is based on Arch Linux ARM and is fully updated from the repository by a regular package manager. Connect to your PiKVM via ssh and run:
 
-    * Ensure the date is correct: `date`. Otherwise you may get the error `SSL certificate problem: certificate is not yet valid`
-    * Run the following:
-
-    ```
-    # date
-    # rw
-    # pacman -Syu
-    # reboot # Allow 2 to 5 minutes for a response.
-    ```
-
-    If you encounter any error during the upgrade, it is most likely due to the upgrade of the Arch Linux ARM repository upstream. In this case, just use our script, which fixes this:
-
-    ```
-    # curl https://files.pikvm.org/update-os.sh | bash
-    ```
-
-    Next time you will be able to use the usual method with `pacman -Syu`.
-
-    Pacman saves all installed packages in a compressed format so that you can roll back to the old version if something goes wrong. After you've updated and made sure everything works, (ONLY for older images, newer images has this partition expended and no longer has this issue) it makes sense to clear the package cache so that it doesn't take up space on the SD card: `rw; rm -rf /var/cache/pacman/pkg; ro`.
+	{!_update_os.md!}
 
 
 ??? question "I don't need ATX functions. How do I disable this in the Web UI?"

docs/first_steps.md

@@ -52,30 +52,17 @@ For future examples, let's assume that your PiKVM has received the address **192
 
     **The default `root` password is `root`.**
 
-PiKVM OS often receives software updates. After installation, it makes sense to update the OS.
-It's best to do this now, when you have physical access to the device, because if something goes wrong
-(for example, the power goes out during the update), you will need to [reflash the memory card](flashing_os.md).
-
 !!! tip "Obtaining root access"
     * If you have logged in via SSH, then most likely you are already `root`.
     * To get `root` in the Web Terminal, use command `su -` and enter the root password.
 
-To update, run these commands under the `root` user:
-
-```console
-[root@pikvm ~]# rw
-[root@pikvm ~]# pacman -Syu
-[root@pikvm ~]# reboot
-```
-
-If you encounter any error during the upgrade, it is most likely due to the upgrade of the Arch Linux ARM repository upstream.
-In this case, just use our script, which fixes this:
+PiKVM OS often receives software updates. After installation, it makes sense to update the OS.
+It's best to do this now, when you have physical access to the device, because if something goes wrong
+(for example, the power goes out during the update), you will need to [reflash the memory card](flashing_os.md).
 
-```console
-[root@pikvm ~]# curl https://files.pikvm.org/update-os.sh | bash
-```
+??? example "Updating PiKVM OS"
 
-Next time you will be able to use the usual method with `pacman -Syu`.
+    {!_update_os.md!}
 
 **And now, after all...**
 

mkdocs.yml

@@ -60,8 +60,9 @@ plugins:
 
 nav:
     - "Getting started":
-        - "PiKVM V4 Mini & Plus guide": v4.md
-        - "PiKVM V3 HAT guide": v3.md
+        - "Device guides":
+            - "PiKVM V4 Mini & Plus": v4.md
+            - "PiKVM V3 HAT": v3.md
         - "First steps": first_steps.md
         - "Authentication": auth.md
         - "FAQ & Troubleshooting": faq.md