Skip to content

Commit 3950686

Browse files
authored
docs: Rewrite sentences and improve personal experiences (#18)
## Summary docs: Rewrite sentences and improve personal experiences ## Type of change <!-- Check all that apply --> - [x] `content` — update or improve existing content - [x] `docs` — changes to CONTRIBUTING, README, or meta documentation ## Checklist - [x] PR title follows the commit convention (e.g. `fix: correct nmcli command in eduroam guide`) - [x] Both EN and NL versions updated (if applicable) - [x] Images are in AVIF format (not PNG/JPG) - [x] No broken image references (`/images/*.avif` all exist in `static/images/`) - [x] Tested locally with `hugo server`
1 parent 00dccd1 commit 3950686

20 files changed

Lines changed: 210 additions & 244 deletions

content/_index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ toc: false
1111

1212
<div class="hx-mb-12">
1313
{{< hextra/hero-subtitle >}}
14-
Everything you should know when running Fedora 43 on your Zephyrus
14+
What I learned running Fedora 43 on my Zephyrus — and what I wish someone had told me
1515
{{< /hextra/hero-subtitle >}}
1616
</div>
1717

@@ -25,7 +25,7 @@ toc: false
2525
<div class="hx-mt-6"></div>
2626

2727
{{< callout type="info" >}}
28-
**Personal Documentation.** This is an independent project where I'm progressively figuring out how to get the most out of Linux on this laptop. Everything here is at your own risk. I'm not responsible for any changes you make to your system. Requires kernel 6.18+.
28+
**Personal documentation.** I'm not a developer or Linux expert — just someone who switched to Linux on this laptop and figured things out along the way. I share what worked for me so others don't have to start from scratch. Everything here is at your own risk. Feel free to reach out if something doesn't work; I'm happy to think along. Requires kernel 6.18+.
2929
{{< /callout >}}
3030

3131
## News

content/_index.nl.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ toc: false
1111

1212
<div class="hx-mb-12">
1313
{{< hextra/hero-subtitle >}}
14-
Alles wat je moet weten over het draaien van Fedora 43 op je Zephyrus
14+
Wat ik leerde van Fedora 43 op mijn Zephyrus — en wat ik had willen weten voordat ik begon
1515
{{< /hextra/hero-subtitle >}}
1616
</div>
1717

@@ -25,7 +25,7 @@ toc: false
2525
<div class="hx-mt-6"></div>
2626

2727
{{< callout type="info" >}}
28-
**Persoonlijke Documentatie.** Dit is een onafhankelijk project waarin ik stap voor stap probeer om steeds meer voor elkaar te krijgen met Linux op deze laptop. Alles wat hier staat is op eigen risico. Ik ben niet verantwoordelijk voor wat je met je systeem doet. Vereist kernel 6.18+.
28+
**Persoonlijke documentatie.** Ik ben geen developer of Linux-expert — gewoon iemand die overgestapt is naar Linux op deze laptop en dingen uitzoekende onderweg. Ik deel wat werkte zodat anderen niet helemaal opnieuw hoeven te beginnen. Alles is op eigen risico. Kom je ergens niet uit, laat het gerust weten — ik denk graag mee. Vereist kernel 6.18+.
2929
{{< /callout >}}
3030

3131
## Nieuws

content/docs/_index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ weight: 1
44
toc: false
55
---
66

7-
# Installation & Configuration Guides
7+
# My Setup Notes
88

9-
Complete setup guides for the ROG Zephyrus G16 on Fedora Linux. Start with the Getting Started guide for a step-by-step walkthrough, or jump directly to a specific reference guide.
9+
Everything I've documented while running Fedora Linux on the ROG Zephyrus G16. Start with Getting Started if you're setting up from scratch, or jump to whichever guide is relevant to your situation.
1010

1111
## Getting Started
1212

content/docs/_index.nl.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,9 @@ weight: 1
44
toc: false
55
---
66

7-
# Installatie & Configuratie Handleidingen
7+
# Mijn setup-notities
88

9-
Volledige handleidingen voor de ROG Zephyrus G16 op Fedora Linux. Begin met de Aan de slag-handleiding voor een stap-voor-stap doorloop, of spring direct naar een specifieke referentiehandleiding.
9+
Alles wat ik heb opgeschreven tijdens het draaien van Fedora Linux op de ROG Zephyrus G16. Begin bij Aan de slag als je vanaf nul instelt, of ga direct naar de handleiding die je nodig hebt.
1010

1111
## Aan de slag
1212

content/docs/asusctl-rog-control.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "asusctl & ROG Control Center"
33
weight: 22
44
---
55

6-
Guide for setting up ASUS ROG hardware controls on Fedora 43: fan curves, performance profiles, GPU switching, Slash LED, and battery management.
6+
The Zephyrus G16 has a lot of hardware features that don't work out of the box on Linux — fan curves, performance profiles, the Slash LED on the lid, GPU switching, battery charge limiting. This page documents how I got all of it working using asusctl and the ASUS Linux project tools. It took some digging to figure out the Fedora-specific parts that their documentation doesn't cover, so I'm writing it down here.
77

88
**Package Information:**
99
- `asusctl` 6.3.2-1 — CLI for fan curves, profiles, battery limit, RGB, Slash LED

content/docs/asusctl-rog-control.nl.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "asusctl & ROG Control Center"
33
weight: 22
44
---
55

6-
Handleiding voor het instellen van ASUS ROG hardware controls op Fedora 43: fan curves, performance profielen, GPU switching, Slash LED en batterijbeheer.
6+
De Zephyrus G16 heeft veel hardware-functies die op Linux niet zomaar werken — fan curves, performance-profielen, de Slash LED op het deksel, GPU-switching, batterijlaadlimiet. Op deze pagina staat hoe ik dat allemaal werkend heb gekregen met asusctl en de tools van het ASUS Linux-project. De Fedora-specifieke onderdelen staan niet in hun eigen documentatie, dus ik heb ze hier opgeschreven.
77

88
**Package informatie:**
99
- `asusctl` 6.3.2 — CLI voor fan curves, profielen, batterijlimiet, RGB, Slash LED

content/docs/autologin.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "GDM Autologin"
33
weight: 19
44
---
55

6-
Skip the GDM login screen after LUKS unlock at boot. The screen lock on suspend/idle still requires your password.
6+
After unlocking the disk with LUKS at boot, I didn't want to type a second password to log in to the desktop. This skips the GDM login screen entirely — you enter your disk password once, and the desktop loads straight away. The screen lock still requires your password as normal.
77

88
**Boot behavior:**
99
- Power on → LUKS password prompt → desktop (no second login)

content/docs/autologin.nl.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "GDM Autologin"
33
weight: 19
44
---
55

6-
Sla het GDM inlogscherm over na LUKS ontgrendeling bij het opstarten. De schermvergrendeling bij slaapstand/inactiviteit vraagt nog steeds om je wachtwoord.
6+
Na het ontgrendelen van de schijf met LUKS bij het opstarten wilde ik niet nog een keer een wachtwoord invoeren om in te loggen. Dit slaat het GDM-inlogscherm volledig over — je voert je schijfwachtwoord één keer in en het bureaublad laadt direct. De schermvergrendeling vraagt gewoon nog steeds om je wachtwoord.
77

88
**Bootgedrag:**
99
- Opstarten → LUKS wachtwoord prompt → bureaublad (geen tweede inlog)

content/docs/eduroam-network-installation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "eduroam Network Installation"
33
weight: 23
44
---
55

6-
The official eduroam installers don't work reliably on modern Linux. On Fedora 43 with NetworkManager 1.50+, the connection hangs during the TLS handshake. I ran into this myself and rewrote the setup script so it works on current systems — I'm sharing it here in case it's useful to others.
6+
Getting eduroam to work on Linux is more painful than it should be. Every "official" method I tried failed on Fedora 43 — the connection would just hang during the TLS handshake and never connect. I eventually figured out a manual setup that works reliably and wrote a script around it. Sharing it here so you hopefully don't have to go through the same process.
77

88
## What doesn't work
99

content/docs/eduroam-network-installation.nl.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: "eduroam Netwerkinstallatie"
33
weight: 23
44
---
55

6-
De officiële eduroam-installers werken niet betrouwbaar op modern Linux. Op Fedora 43 met NetworkManager 1.50+ blijft de verbinding hangen tijdens de TLS-handshake. Ik liep hier zelf tegenaan en heb het installatiescript herschreven zodat het werkt op actuele systemen — ik deel het hier voor anderen die hetzelfde probleem hebben.
6+
eduroam werkend krijgen op Linux is pijnlijker dan het zou moeten zijn. Elke "officiële" methode die ik probeerde faalde op Fedora 43 — de verbinding bleef gewoon hangen tijdens de TLS-handshake en verbond nooit. Uiteindelijk heb ik een handmatige setup gevonden die betrouwbaar werkt en daar een script omheen geschreven. Ik deel het hier zodat jij hopelijk niet hetzelfde proces hoeft door te maken.
77

88
## Wat niet werkt
99

0 commit comments

Comments
 (0)