commit 5d7a8d2e8f0275bdde379b95b2c94a789acd00af
from: Bradley Taunt <bt@btxx.org>
date: Tue Oct 22 17:03:43 2024 UTC

Better README descriptions, reorder things

commit - ea201a0ba76f31de945d153602ead0cb01be01e3
commit + 5d7a8d2e8f0275bdde379b95b2c94a789acd00af
blob - 77443b68811d12f1970c1cf0c9ada1fa83c88b5b
blob + 193efbd566b233b3ed6b27ad40b7600acd0f4de5
--- README.md
+++ README.md
@@ -4,15 +4,28 @@ Lightweight Desktop installer for Alpine Linux based o
 
 ![Screenshot of dwm running on Alpine Linux](https://git.btxx.org/screenshots/alpine-suck.png)
 
-Includes my own custom set of suckless tools (dwm, slstatus, dmenu, etc.). Ships with `ohmyzsh` and personal `vim` configs. Uses `qutebrowser` for default browser.
+Includes my own custom set of suckless tools (dwm, slstatus, dmenu, etc.). Ships with `ohmyzsh` and my personal `vim` configs.
 
+## What You Get
+
+The Open Suck installer gives you the absolute barebones desktop experience:
+
+- `dwm` for window management
+- `ranger` for your file browser
+- `firefox` as your core web browser
+- `aerc` for your terminal-based mail client
+- `slock` for screen locking
+- `scrot`/`slop` for simple screenshot utilities
+- `feh` for your image/file viewing
+- `dunst` for notifications
+
 ## Downloading
 
 1. Download the latest Alpine image
 2. Run `setup-alpine`
 3. Run `setup-xorg-base`
 4. [Enable community/edge/testing repos](https://wiki.alpinelinux.org/wiki/Repositories#Enabling_the_community_repository)
-5. Install git, vim & doas
+5. Install git, vim & doas (doas is better than sudo!)
 6. Edit doas permissions (`/etc/doas.conf`):
 
 ```
@@ -47,29 +60,31 @@ cd alpine-suck
 
 ## Installing
 
-1. Install dependencies by running `./install-dependencies.sh`
-2. Compile and install suckless software by running the `./install.sh`
+1. Install dependencies
+2. Compile and install suckless software
 
 ## TLDR
 
-```sh
-cd alpine-suck # CD into this repository
-doas sh ./install-dependencies.sh # Install alpine packages
-```
+**Warning**: Change the `$ALPINE_USER` variable inside `install-dependencies.sh` to match that of your current
+user.
 
-Be sure to change the `$ALPINE_USER` variable to match that of your current
-user:
-
 ```
 $ALPINE_USER="bt"
 ```
 
-Then run the script to build suckless programs:
+Then continue...
 
 ```sh
-doas sh ./install.sh # Install everything
+cd alpine-suck # CD into this repository
+doas sh ./install-dependencies.sh # Install alpine packages
 ```
 
+Give that some time. Once it is complete, run `install.sh` to build the suckless programs:
+
+```sh
+doas sh ./install.sh # Build & install everything
+```
+
 Reboot the machine. Log in as your main user. Run:
 
 ```