docs: Update multiple docs

.markdownlint.yml

@@ -40,3 +40,11 @@ MD040: false
 
 # Headings surrounded by blank lines — pre-existing violations in some docs
 MD022: false
+
+# Heading levels increment by one — Hugo docs intentionally start at ### because
+# h1/h2 are rendered by the theme template, not the content file
+MD001: false
+
+# Table column style (pipe spacing/alignment) — overly pedantic, tables render
+# correctly regardless of exact pipe spacing
+MD060: false

README.md

@@ -2,14 +2,16 @@
 
 English | [Nederlands](README.nl.md)
 
-Fedora 43 on the ASUS ROG Zephyrus G16 GA605WV (2024). Step-by-step guides for NVIDIA drivers, VMs, YubiKey, and more.
+Fedora 43 on the ASUS ROG Zephyrus G16 GA605WV (2024). My personal setup log — documenting what worked, what didn't, and how I fixed it.
 
 **Browse the full documentation site: [zephyrus-linux.stentijhuis.nl](https://zephyrus-linux.stentijhuis.nl/)**
 
 
 ## About this project
 
-This is an independent personal project where I document my own findings while setting up and daily-driving Fedora Linux on this laptop. I'm still actively testing and experimenting — things may change, break, or turn out to be wrong. Everything here is based on my own experience and should be taken as-is, at your own risk.
+This is my personal setup log for running Fedora Linux on this laptop. I'm not a software engineer or developer — just someone who switched to Linux and ran into a lot of things that didn't work out of the box. I figured I'd write it all down so others don't have to go through the same trial and error I did.
+
+I'm still actively testing and experimenting — things may change, break, or turn out to be wrong. Everything here is based on my own experience and should be taken as-is, at your own risk.
 
 I am not affiliated with, endorsed by, or acting on behalf of ASUS, NVIDIA, Microsoft, Fedora, or any other company or project mentioned here.
 

README.nl.md

@@ -2,14 +2,16 @@
 
 Nederlands | [English](README.md)
 
-Fedora 43 op de ASUS ROG Zephyrus G16 GA605WV (2024). Handleidingen voor NVIDIA drivers, VMs, YubiKey en meer.
+Fedora 43 op de ASUS ROG Zephyrus G16 GA605WV (2024). Mijn persoonlijke setup-log — wat werkte, wat niet, en hoe ik het heb opgelost.
 
 **Bekijk de volledige documentatiesite: [zephyrus-linux.stentijhuis.nl](https://zephyrus-linux.stentijhuis.nl/nl/)**
 
 
 ## Over dit project
 
-Dit is een onafhankelijk persoonlijk project waarin ik mijn eigen bevindingen documenteer bij het opzetten en dagelijks gebruiken van Fedora Linux op deze laptop. Ik ben nog actief aan het testen en experimenteren — dingen kunnen veranderen, kapot gaan of achteraf onjuist blijken. Alles wat hier staat is gebaseerd op mijn eigen ervaring en is op eigen risico.
+Dit is mijn persoonlijke setup-log voor Fedora Linux op deze laptop. Ik ben geen software-engineer of developer — gewoon iemand die naar Linux is overgestapt en daarna tegen van alles aanliep wat niet meteen werkte. Ik heb alles opgeschreven zodat anderen niet hetzelfde hoeven uitzoeken als ik.
+
+Ik ben nog actief aan het testen en experimenteren — dingen kunnen veranderen, kapot gaan of achteraf onjuist blijken. Alles wat hier staat is gebaseerd op mijn eigen ervaring en is op eigen risico.
 
 Ik ben niet gelieerd aan, goedgekeurd door, of handelend namens ASUS, NVIDIA, Microsoft, Fedora, of enig ander bedrijf of project dat hier wordt genoemd.
 

content/docs/getting-started.md

@@ -13,15 +13,15 @@ The steps below are roughly in the order I set things up after a fresh Fedora 43
 
 ### Brave browser — RPM with Wayland workarounds
 
-I use Brave as my main browser. I started with the Flatpak version but switched to the native RPM for better system integration. There's a catch though: Brave 1.82+ has three crash bugs on GNOME Wayland that need workarounds before it's actually stable. I don't fully understand why these crashes happen — they seem to involve GPU drivers and Wayland protocols that are apparently not playing well together — but the fixes below work for me.
+I use Brave as my main browser. I started with the Flatpak version but switched to the native RPM — according to people on Reddit, the RPM version feels more native and offers better performance and efficiency. There's a catch though: Brave 1.82+ has two crash bugs on GNOME Wayland that need workarounds before it's actually stable. I don't fully understand why these crashes happen — they seem to involve GPU drivers and Wayland protocols that are apparently not playing well together — but the fixes below work for me.
 
-- **RPM (native):** Better performance and system integration. This is what I use.
+- **RPM (native):** More native feel, better performance and efficiency. This is what I use.
 - **Flatpak:** Might work better in some situations, but it feels a bit more isolated and slightly slower.
 
 **RPM Installation**
 
 {{< callout type="warning" >}}
-On Fedora with GNOME + Wayland, Brave 1.82+ has three known crash bugs that require workarounds. The first two are applied via the desktop entry; the third requires a setting in `brave://flags`.
+On Fedora with GNOME + Wayland, Brave 1.82+ has two known crash bugs that require workarounds. The first is applied via the desktop entry; the second requires a setting in `brave://flags`.
 {{< /callout >}}
 
 ```bash
@@ -32,25 +32,25 @@ sudo dnf install brave-browser
 
 ![Brave install instructions](/images/brave-install.avif)
 
-**Workarounds 1 & 2: patch the desktop entry**
+**Workaround 1: patch the desktop entry**
 
 Copy the system desktop entry to your user directory so it doesn't get overwritten by updates:
 ```bash
 sudo cp /usr/share/applications/brave-browser.desktop ~/.local/share/applications/
 ```
 
-Patch all three `Exec=` lines with both flags:
+Patch all three `Exec=` lines with the flag:
 ```bash
 sed -i \
-  's|Exec=/usr/bin/brave-browser-stable %U|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11 %U|' \
+  's|Exec=/usr/bin/brave-browser-stable %U|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 %U|' \
   ~/.local/share/applications/brave-browser.desktop
 
 sed -i \
-  's|Exec=/usr/bin/brave-browser-stable$|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11|' \
+  's|Exec=/usr/bin/brave-browser-stable$|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1|' \
   ~/.local/share/applications/brave-browser.desktop
 
 sed -i \
-  's|Exec=/usr/bin/brave-browser-stable --incognito$|Exec=/usr/bin/brave-browser-stable --incognito --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11|' \
+  's|Exec=/usr/bin/brave-browser-stable --incognito$|Exec=/usr/bin/brave-browser-stable --incognito --disable-features=WaylandWpColorManagerV1|' \
   ~/.local/share/applications/brave-browser.desktop
 ```
 
@@ -59,20 +59,16 @@ Verify it worked — you should see exactly three `Exec=` lines:
 grep "^Exec" ~/.local/share/applications/brave-browser.desktop
 ```
 
-**What these flags actually do (as far as I understand it):**
+**What this flag actually does (as far as I understand it):**
 
 `--disable-features=WaylandWpColorManagerV1` — Brave 1.82+ introduced some Wayland color management extension that apparently conflicts with the AMD amdgpu driver on Fedora + GNOME Wayland. Without this flag, Brave triggers GPU ring timeouts that crash the entire GNOME Shell session. I have no idea why a browser color management feature would take down the whole desktop, but here we are.
 
-`--ozone-platform=x11` — This forces Brave to run via XWayland instead of native Wayland. It fixes a hard crash that happens when you try to open a Bitwarden attachment download. Apparently Brave tries to do something with a Wayland protocol in a way that's not valid, and it immediately crashes. Running via XWayland sidesteps the whole thing. You lose some native Wayland features like fractional scaling, but the browser actually stays open, which feels like a reasonable trade.
+**A note on `--ozone-platform=x11`:** I tried this flag as a workaround for a crash when opening or downloading Bitwarden attachments — Brave does something with a Wayland protocol in a way that's not valid and immediately crashes. Running via XWayland sidesteps that. It turned out to cause a worse problem though: gnome-shell crashing with `SIGABRT` (`g_assertion_message_expr` in `meta_window_unmanage`), triggered during Picture-in-Picture video while Brave was running via XWayland — the same underlying mutter crash documented in [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) and [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). That takes down the entire desktop session and requires a hard reboot. The flag is gone. Brave now runs on native Wayland. The Bitwarden attachment crash still exists, but a Brave crash is preferable to losing the whole session.
 
-{{< callout type="info" >}}
-Always launch Brave from the GNOME dock or app launcher — not from the terminal. When you launch it from a terminal inside a Wayland session, the terminal's environment overrides the `--ozone-platform=x11` flag and Brave falls back to native Wayland, bringing all the crashes back.
-{{< /callout >}}
-
-**Third workaround: disable hardware video decode in `brave://flags`**
+**Second workaround: disable hardware video decode in `brave://flags`**
 
 {{< callout type="warning" >}}
-Hardware video decode still causes crashes even with the two flags above. As long as the AMD VCN decoder is active, GNOME Shell crashes with SIGABRT (`g_assertion_message_expr`) — reproducible during Picture-in-Picture video and intensive video activity. See [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) and [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). Hardware video decode is **not yet stable** on the AMD Radeon 890M with GNOME Wayland.
+Hardware video decode still causes crashes even with the flag above. As long as the AMD VCN decoder is active, GNOME Shell crashes with SIGABRT (`g_assertion_message_expr`) — reproducible during Picture-in-Picture video and intensive video activity. See [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) and [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). Hardware video decode is **not yet stable** on the AMD Radeon 890M with GNOME Wayland.
 {{< /callout >}}
 
 Go to `brave://flags` and disable:
@@ -337,17 +333,18 @@ Coming from Windows, some things feel off without the right shortcuts. These are
 
 **Built-in shortcuts (via Settings > Keyboard > Keyboard Shortcuts):**
 
-| # | Action | Shortcut | Category |
-|---|--------|----------|----------|
-| 1 | Show desktop (hide all windows) | `Super+D` | Navigation |
-| 2 | Take a screenshot interactively | `Shift+Super+S` | Screenshots |
-| 3 | Open Settings | `Super+I` | System |
+| # | Action | Shortcut |
+|---|--------|----------|
+| 1 | Show desktop (hide all windows) | `Super+D` |
+| 2 | Take a screenshot interactively | `Shift+Super+S` |
+| 3 | Record a screencast interactively | `Shift+Super+R` |
+| 4 | Open Settings | `Super+I` |
 
 **Custom shortcut (via Settings > Keyboard > Keyboard Shortcuts > Custom Shortcuts):**
 
 | # | Action | Command | Shortcut |
 |---|--------|---------|----------|
-| 4 | Open file manager | `nautilus` | `Super+E` |
+| 5 | Open file manager | `nautilus` | `Super+E` |
 
 GNOME doesn't have a built-in shortcut for the file manager, so this one needs to be created manually.
 

content/docs/getting-started.nl.md

@@ -13,15 +13,15 @@ De stappen hieronder zijn in grote lijnen de volgorde waarop ik dingen heb opgez
 
 ### Brave browser — RPM met Wayland-workarounds
 
-Brave is mijn standaardbrowser. Ik begon met de Flatpak-versie maar ben overgestapt naar de native RPM voor betere systeemintegratie. Er is alleen een addertje: Brave 1.82+ heeft drie crashbugs op GNOME Wayland die je moet oplossen voordat het écht stabiel is. Ik snap niet helemaal waarom die crashes plaatsvinden — het gaat om GPU-drivers en Wayland-protocollen die blijkbaar niet goed samenwerken — maar de onderstaande fixes werken voor mij.
+Brave is mijn standaardbrowser. Ik begon met de Flatpak-versie maar ben overgestapt naar de native RPM — mensen op Reddit zeggen dat de RPM-versie nativer aanvoelt en betere prestaties en efficiëntie biedt. Er is alleen een addertje: Brave 1.82+ heeft twee crashbugs op GNOME Wayland die je moet oplossen voordat het écht stabiel is. Ik snap niet helemaal waarom die crashes plaatsvinden — het gaat om GPU-drivers en Wayland-protocollen die blijkbaar niet goed samenwerken — maar de onderstaande fixes werken voor mij.
 
-- **RPM (native):** Betere prestaties en systeemintegratie. Dit gebruik ik.
+- **RPM (native):** Nativer gevoel, betere prestaties en efficiëntie. Dit gebruik ik.
 - **Flatpak:** Kan in sommige situaties beter werken, maar voelt wat meer geïsoleerd en iets trager.
 
 **RPM Installatie**
 
 {{< callout type="warning" >}}
-Op Fedora met GNOME + Wayland heeft Brave 1.82+ drie bekende crashbugs waarvoor workarounds nodig zijn. De eerste twee worden via de desktop entry toegepast; de derde vereist een instelling in `brave://flags`.
+Op Fedora met GNOME + Wayland heeft Brave 1.82+ twee bekende crashbugs waarvoor workarounds nodig zijn. De eerste wordt via de desktop entry toegepast; de tweede vereist een instelling in `brave://flags`.
 {{< /callout >}}
 
 ```bash
@@ -32,25 +32,25 @@ sudo dnf install brave-browser
 
 ![Brave installatie-instructies](/images/brave-install.avif)
 
-**Workarounds 1 & 2: de desktop entry patchen**
+**Workaround 1: de desktop entry patchen**
 
 Kopieer de systeem-desktop entry naar je gebruikersmap zodat hij niet wordt overschreven bij updates:
 ```bash
 sudo cp /usr/share/applications/brave-browser.desktop ~/.local/share/applications/
 ```
 
-Patch alle drie de `Exec=` regels met beide flags:
+Patch alle drie de `Exec=` regels met de flag:
 ```bash
 sed -i \
-  's|Exec=/usr/bin/brave-browser-stable %U|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11 %U|' \
+  's|Exec=/usr/bin/brave-browser-stable %U|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 %U|' \
   ~/.local/share/applications/brave-browser.desktop
 
 sed -i \
-  's|Exec=/usr/bin/brave-browser-stable$|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11|' \
+  's|Exec=/usr/bin/brave-browser-stable$|Exec=/usr/bin/brave-browser-stable --disable-features=WaylandWpColorManagerV1|' \
   ~/.local/share/applications/brave-browser.desktop
 
 sed -i \
-  's|Exec=/usr/bin/brave-browser-stable --incognito$|Exec=/usr/bin/brave-browser-stable --incognito --disable-features=WaylandWpColorManagerV1 --ozone-platform=x11|' \
+  's|Exec=/usr/bin/brave-browser-stable --incognito$|Exec=/usr/bin/brave-browser-stable --incognito --disable-features=WaylandWpColorManagerV1|' \
   ~/.local/share/applications/brave-browser.desktop
 ```
 
@@ -59,20 +59,16 @@ Controleer of het gelukt is — je zou exact drie `Exec=` regels moeten zien:
 grep "^Exec" ~/.local/share/applications/brave-browser.desktop
 ```
 
-**Wat deze flags doen (voor zover ik het begrijp):**
+**Wat deze flag doet (voor zover ik het begrijp):**
 
 `--disable-features=WaylandWpColorManagerV1` — Brave 1.82+ introduceerde een Wayland color management extensie die blijkbaar conflicteert met de AMD amdgpu-driver op Fedora + GNOME Wayland. Zonder deze flag veroorzaakt Brave GPU ring timeouts die de volledige GNOME Shell-sessie laten crashen. Ik heb geen idee waarom een browser-kleurbeheerfunctie het hele bureaublad kan neerhalen, maar hier zijn we dan.
 
-`--ozone-platform=x11` — Dit forceert Brave om via XWayland te draaien in plaats van native Wayland. Het verhelpt een harde crash die optreedt als je een Bitwarden-bijlage probeert te downloaden. Blijkbaar doet Brave dan iets met een Wayland-protocol op een manier die niet geldig is, en dan crasht hij direct. Via XWayland omzeil je dat probleem. Je verliest een paar native Wayland-voordelen zoals fractional scaling, maar de browser blijft open — dat voelt als een redelijke afweging.
+**Een noot over `--ozone-platform=x11`:** Ik heb deze flag geprobeerd als workaround voor een crash bij het openen of downloaden van Bitwarden-bijlagen — Brave doet dan iets met een Wayland-protocol op een manier die niet geldig is en crasht direct. Via XWayland omzeil je dat. Maar het bleek een erger probleem te veroorzaken: gnome-shell crashte met `SIGABRT` (`g_assertion_message_expr` in `meta_window_unmanage`), getriggerd tijdens Picture-in-Picture video terwijl Brave via XWayland draaide — dezelfde onderliggende mutter-crash als gedocumenteerd in [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) en [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). Die crash slaat de hele bureaublad-sessie neer en vereist een harde herstart. De flag is weg. Brave draait nu op native Wayland. De Bitwarden-bijlage-crash bestaat nog steeds, maar een Brave-crash is te verkiezen boven het verliezen van de hele sessie.
 
-{{< callout type="info" >}}
-Start Brave altijd vanuit het GNOME-dock of de app launcher — niet vanuit de terminal. Als je hem vanuit een terminal in een Wayland-sessie start, overschrijven de omgevingsvariabelen van de terminal de `--ozone-platform=x11` flag en valt Brave terug op native Wayland, met alle crashes van dien.
-{{< /callout >}}
-
-**Derde workaround: hardware video decode uitschakelen in `brave://flags`**
+**Tweede workaround: hardware video decode uitschakelen in `brave://flags`**
 
 {{< callout type="warning" >}}
-Hardware video decode veroorzaakt nog steeds crashes, ook met de twee flags hierboven. Zolang de AMD VCN decoder actief is, crasht GNOME Shell met een SIGABRT (`g_assertion_message_expr`) — reproduceerbaar bij Picture-in-Picture video en bij intensief videobeheer. Zie [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) en [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). Hardware video decode is **nog niet stabiel** op de AMD Radeon 890M met GNOME Wayland.
+Hardware video decode veroorzaakt nog steeds crashes, ook met de flag hierboven. Zolang de AMD VCN decoder actief is, crasht GNOME Shell met een SIGABRT (`g_assertion_message_expr`) — reproduceerbaar bij Picture-in-Picture video en bij intensief videobeheer. Zie [gnome-mutter issue #4625](https://gitlab.gnome.org/GNOME/mutter/-/issues/4625) en [Fedora bugzilla #2440608](https://bugzilla.redhat.com/show_bug.cgi?id=2440608). Hardware video decode is **nog niet stabiel** op de AMD Radeon 890M met GNOME Wayland.
 {{< /callout >}}
 
 Ga naar `brave://flags` en schakel uit:
@@ -337,17 +333,18 @@ Als je vanuit Windows komt, voelt een paar dingen meteen anders zonder de juiste
 
 **Ingebouwde sneltoetsen (via Settings > Keyboard > Keyboard Shortcuts):**
 
-| # | Actie | Sneltoets | Categorie |
-|---|-------|-----------|-----------|
-| 1 | Desktop tonen (alle vensters verbergen) | `Super+D` | Navigation |
-| 2 | Interactieve screenshot | `Shift+Super+S` | Screenshots |
-| 3 | Instellingen openen | `Super+I` | System |
+| # | Actie | Sneltoets |
+|---|-------|-----------|
+| 1 | Desktop tonen (alle vensters verbergen) | `Super+D` |
+| 2 | Interactieve screenshot | `Shift+Super+S` |
+| 3 | Interactieve schermopname | `Shift+Super+R` |
+| 4 | Instellingen openen | `Super+I` |
 
 **Custom shortcut (via Settings > Keyboard > Keyboard Shortcuts > Custom Shortcuts):**
 
 | # | Actie | Commando | Sneltoets |
 |---|-------|----------|-----------|
-| 4 | Bestandsbeheer openen | `nautilus` | `Super+E` |
+| 5 | Bestandsbeheer openen | `nautilus` | `Super+E` |
 
 GNOME heeft standaard geen sneltoets voor de bestandsbeheerder, dus die moet je handmatig aanmaken.