update documentation to reflect best-practices (#857)

* update tailscale.md to reflect best-practices

The provided -Syy is supposed to be used to redownload all package databases,
while the command chain itself is a partial upgrade which is not recommended
either for rolling release distributions.

Replace the full database redownload with a database update and run a system
upgrade while installing tailscaled.

* remove unnecessary sync command from video.md

* remove unnecessary sync command from bluetooth_hid.md

* remove unnecessary sync command from arduino_hid.md

* update faq.md to reflect best practices

* update letsencrypt.md to keep system up-to-date when installing packages

docs/arduino_hid.md

@@ -179,8 +179,7 @@ Programming assumes the Arduino is powered via USB, either from the connected ho
 As of the latest package release, the kdmd service supports SPI. It should be sufficient to ensure the packages are up-to-date with the latest release, the programmer is installed, and the SPI device overlay is loaded at boot.
 
 * Switch the filesystem to read-write mode with `rw`
-* Update the system with `pacman -Syu` for the latest packages
-* Install the avrdude programmer with `pacman -S avrdude-svn`
+* Update the system and nstall the avrdude programmer `pacman -Syu avrdude-svn`
 * Add `dtoverlay=spi0-1cs` to `/boot/config.txt`
 * Reboot with `reboot` or `systemctl reboot`
 

docs/bluetooth_hid.md

@@ -16,8 +16,7 @@ This is not the main case of using PiKVM since you still need it to pair with a
 
     ```
     # rw
-    # pacman -Syu
-    # pacman -S bluez bluez-utils raspberrypi-bluetooth
+    # pacman -Syu bluez bluez-utils raspberrypi-bluetooth
     ```
 
 2. Edit `/boot/config.txt` and comment these lines:

docs/faq.md

@@ -243,9 +243,9 @@ As a first step, we recommend carefully reading our documentation on [GitHub](ht
     PiKVM OS is based on Arch Linux ARM and uses the [pacman](https://wiki.archlinux.org/title/Pacman) package manager.
 
     * Switch filesystem to RW-mode: `rw`.
-    * Update the package cache: `pacman -Syy`.
     * Find some packages (`emacs` for example): `pacman -Ss emacs`.
-    * Install it: `pacman -S emacs`.
+    * Install it, while keeping the system updated: `pacman -Syu emacs`.
+    * To only update packages without installing new ones, use `pacman -Syu`
     * Remove it: `pacman -R emacs`.
     * Switch filesystem to RO-mode: `ro`.
 

docs/letsencrypt.md

@@ -52,7 +52,7 @@ This example shows that PiKVM may not be accessible from the internet, but you c
 1. Switch filesystem to RW and install the Cloudflare DNS plugin:
    ```
    # rw
-   # pacman -S certbot-dns-cloudflare
+   # pacman -Syu certbot-dns-cloudflare
    ```
 
 2. Prepare the environment for the DNS plugin (place the auth data):
@@ -84,7 +84,7 @@ This example shows that PiKVM may not be accessible from the internet, but you c
 1. Switch filesystem to RW and install the Route53 DNS plugin:
    ```
    # rw
-   # pacman -S certbot-dns-route53
+   # pacman -Syu certbot-dns-route53
    ```
 
 2. Configure Your AWS User

docs/tailscale.md

@@ -11,8 +11,7 @@
 
     ```
     # rw
-    # pacman -Syy
-    # pacman -S tailscale-pikvm
+    # pacman -Syu tailscale-pikvm
     # systemctl enable --now tailscaled
     # tailscale up
     ```

docs/video.md

@@ -9,8 +9,7 @@
 
     ```
     # rw
-    # pacman -Syu
-    # pacman -S ffmpeg
+    # pacman -Syu ffmpeg
     ```
 
 2. For USB dongle only: Add line `gpu_mem=256` to `/boot/config.txt`.